tamga-ui 0.1.0

package/dist/components/badge.js

@@ -0,0 +1,29 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { toneOf, rankOf } from "./tone.js";
+import { useLiveClaim } from "./live-scope.js";
+/* `live` is a REQUEST, not a decision. The element asks the nearest LiveScope
+   to pulse and only the most severe asker wins — see live-scope.tsx. Call sites
+   keep writing `live={m.health === "down"}` exactly as before; the counting is
+   no longer their problem. */
+export function StatusChip({ label, state, dot = true, live = false, mono = false, severity, }) {
+    const h = toneOf(state);
+    const pulses = useLiveClaim(live ? rankOf(state, severity) : null);
+    return (_jsxs("span", { className: `tamga-chip ${mono ? "tamga-chip-mono" : ""}`, style: { background: h.bg, color: h.fg }, children: [dot && (_jsx("span", { className: `inline-block size-[var(--mark-dot)] ${pulses ? "tamga-live" : ""}`, style: { background: h.mark } })), label] }));
+}
+export function Delta({ value, better, mono = true, }) {
+    /* good movement stays neutral — color is reserved for deviation */
+    const color = better ? "var(--color-ink-faint)" : "var(--color-critical)";
+    const rising = !value.trimStart().startsWith("-");
+    return (_jsxs("span", { className: `inline-flex items-center gap-1 text-small font-bold ${mono ? "font-mono" : ""}`, style: { color }, children: [_jsx("svg", { width: "9", height: "9", viewBox: "0 0 10 10", "aria-hidden": true, children: _jsx("path", { d: rising ? "M5 1L9 8H1Z" : "M5 9L1 2H9Z", style: { fill: color } }) }), value] }));
+}
+/**
+ * Solid square status mark used in dense tables. Uses `fg` rather than `mark`
+ * so a single 10px square still reads at rest — bars can afford to be quieter,
+ * a lone dot cannot.
+ */
+export function Dot({ state, live = false, severity, }) {
+    const h = toneOf(state);
+    const pulses = useLiveClaim(live ? rankOf(state, severity) : null);
+    return (_jsx("span", { className: `inline-block size-2.5 shrink-0 ${pulses ? "tamga-live" : ""}`, style: { background: h.fg }, "aria-hidden": true }));
+}

package/dist/components/bar.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Yatay çubuk grafik — SIRALAMA ve KARŞILAŞTIRMA.
+ *
+ * Gerekçe: docs/gerekce/03-grafik-ve-olcum.md
+ */
+export type Bar = {
+    label: string;
+    value: number;
+    /**
+     * The second, faint value beside the number: usually a share ("2.4%"). WHY THE COMPONENT DOES
+     * NOT COMPUTE IT. In a bar chart the DENOMINATOR of a share is usually NOT the sum of the
+     * rows drawn: in "top ten customers by orders" the meaningful denominator is every order in
+     * the period, not the sum of those ten. The component cannot know the denominator, and if it
+     * guessed it would guess wrong. TR: Sayının yanındaki ikinci, soluk değer: genelde bir pay
+     * ("%2.4"). NEDEN BİLEŞEN HESAPLAMIYOR. Bir çubuk grafikte payın PAYDASI çoğu zaman çizilen
+     * satırların toplamı DEĞİLDİR: "en çok sipariş veren on müşteri"de anlamlı payda dönemin
+     * bütün siparişleridir, o on kişinin toplamı değil. Paydayı bileşen bilemez; bilse de yanlış
+     * bilir.
+     */
+    note?: string;
+};
+export declare function BarChart({ bars, formatValue, labelWidth, className, }: {
+    bars: readonly Bar[];
+    formatValue?: (v: number) => string;
+    /**
+     * The width of the name column; the caller picks it from the longest name. TR: Ad sütununun
+     * genişliği; en uzun ada göre çağıran seçiyor.
+     */
+    labelWidth?: string;
+    className?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=bar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bar.d.ts","sourceRoot":"","sources":["../../src/components/bar.tsx"],"names":[],"mappings":"AAKA;;;;GAIG;AAEH,MAAM,MAAM,GAAG,GAAG;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AASF,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,WAAoB,EACpB,UAAoB,EACpB,SAAS,GACV,EAAE;IACD,IAAI,EAAE,SAAS,GAAG,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BA4DA"}

package/dist/components/bar.js

@@ -0,0 +1,33 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { cn } from "../lib/cn.js";
+/** Sayıyı ızgara çizgisine yuvarlar: 87 → 100, 412 → 500. */
+function niceMax(v) {
+    if (v <= 0)
+        return 1;
+    const mag = 10 ** Math.floor(Math.log10(v));
+    return Math.ceil(v / mag) * mag;
+}
+export function BarChart({ bars, formatValue = String, labelWidth = "10rem", className, }) {
+    const enBuyuk = niceMax(Math.max(0, ...bars.map((b) => b.value)));
+    /* SATIRIN TAMAMI VURGULANIYOR, yalnız çubuk değil: uzun bir listede gözün
+       kaydığı şey satır. Ad solda, sayı sağda, arada bir metre uzunluğunda
+       çubuk var; hangi adın hangi sayıya ait olduğunu takip etmek zorlaşıyor ve
+       satır zemini o izi tutuyor. */
+    const [uzerinde, setUzerinde] = useState(null);
+    return (_jsxs("div", { className: cn("flex flex-col gap-0.5", className), onMouseLeave: () => setUzerinde(null), children: [bars.map((b) => {
+                const oran = enBuyuk > 0 ? b.value / enBuyuk : 0;
+                const secili = uzerinde === b.label;
+                return (_jsxs("div", { className: "grid cursor-default items-center gap-3 rounded-(--radius-mark) px-1.5 py-1 transition-[background] duration-(--duration-press)", style: {
+                        gridTemplateColumns: `${labelWidth} minmax(0,1fr) auto`,
+                        background: secili ? "var(--color-hover)" : undefined,
+                    }, onMouseEnter: () => setUzerinde(b.label), children: [_jsx("span", { className: "truncate text-right text-small", style: { color: secili ? "var(--color-ink)" : "var(--color-ink-soft)" }, title: b.label, children: b.label }), _jsx("span", { className: "relative block h-4 rounded-(--radius-mark) bg-[var(--color-chart-fill)]", children: _jsx("span", { className: "absolute inset-y-0 left-0 rounded-(--radius-mark) transition-[background] duration-(--duration-press)", style: {
+                                    width: `${Math.max(oran * 100, b.value > 0 ? 1.5 : 0)}%`,
+                                    /* Üzerine gelinen çubuk bir kademe koyu: aynı hue, farklı
+                                       ton. Renk değiştirmek çubuğu başka bir seriye ait
+                                       gösterirdi. */
+                                    background: secili ? "var(--color-accent-line)" : "var(--color-chart-3)",
+                                } }) }), _jsxs("span", { className: "tabular-nums text-small", style: { color: secili ? "var(--color-ink)" : "var(--color-ink-soft)" }, children: [formatValue(b.value), b.note && _jsx("span", { className: "ml-1.5 text-ink-faint", children: b.note })] })] }, b.label));
+            }), bars.length === 0 && _jsx("p", { className: "text-ink-faint", children: "G\u00F6sterilecek veri yok." })] }));
+}

package/dist/components/button.d.ts

@@ -0,0 +1,45 @@
+import { type VariantProps } from "class-variance-authority";
+/**
+ * The button family, typed.
+ *
+ * Gerekçe: docs/gerekce/06-isaret-ve-ton.md
+ */
+export declare const buttonVariants: (props?: ({
+    variant?: "danger" | "ghost" | "link" | "primary" | "secondary" | "success" | null | undefined;
+    size?: "base" | "sm" | null | undefined;
+    full?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type ButtonProps = React.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
+    /**
+     * The click is still running. TR: Tıklama hâlâ sürüyor.
+     *
+     * Sürerken düğme kilitleniyor ve etiketinin yerine bir spinner geçiyor.
+     * Bunun düğmenin kendisinde olmasının sebebi ölçülebilir: her çağrı yeri
+     * kendi kilidini yazdığında biri unutuluyor, ve unutulan yer çift gönderim
+     * demek. Bir kez yazılan bir kural, altmış çağrı yerinde hatırlanan bir
+     * kuraldan güvenli.
+     */
+    busy?: boolean;
+    /**
+     * What the spinner announces while `busy`. TR: Spinner sürerken ekran
+     * okuyucunun söylediği şey.
+     *
+     * ZORUNLU DEĞİL AMA VARSAYILANI YOK: kit çeviri yapmıyor, ve "Loading"
+     * diye İngilizce bir varsayılan her Türkçe panele İngilizce bir cümle
+     * gönderirdi. Verilmezse düğmenin kendi metni okunuyor.
+     */
+    busyLabel?: string;
+};
+export declare function Button({ className, variant, size, full, busy, busyLabel, children, disabled, ...props }: ButtonProps): import("react").JSX.Element;
+export declare const iconButtonVariants: (props?: ({
+    size?: "base" | "sm" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/** 40px square. Always needs an aria-label — there is no text to read. */
+export declare function IconButton({ className, size, "aria-label": label, ...props }: React.ComponentProps<"button"> & VariantProps<typeof iconButtonVariants> & {
+    "aria-label": string;
+}): import("react").JSX.Element;
+/** The densest member: 1px at rest, 2px on hover, and its edge turns accent. */
+export declare function MiniButton({ className, "aria-label": label, ...props }: React.ComponentProps<"button"> & {
+    "aria-label": string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=button.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../src/components/button.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIlE;;;;GAIG;AAEH,eAAO,MAAM,cAAc;;;;8EA2BzB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,GACtD,YAAY,CAAC,OAAO,cAAc,CAAC,GAAG;IACpC;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEJ,wBAAgB,MAAM,CAAC,EACrB,SAAS,EACT,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,IAAY,EACZ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,WAAW,+BA2Bb;AAID,eAAO,MAAM,kBAAkB;;8EAG7B,CAAC;AAEH,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,EACzB,SAAS,EACT,IAAI,EACJ,YAAY,EAAE,KAAK,EACnB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,GAC/B,YAAY,CAAC,OAAO,kBAAkB,CAAC,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,+BASnE;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,EACzB,SAAS,EACT,YAAY,EAAE,KAAK,EACnB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,+BAS3D"}

package/dist/components/button.js

@@ -0,0 +1,56 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cva } from "class-variance-authority";
+import { cn } from "../lib/cn.js";
+import { Spinner } from "./spinner.js";
+/**
+ * The button family, typed.
+ *
+ * Gerekçe: docs/gerekce/06-isaret-ve-ton.md
+ */
+export const buttonVariants = cva("tamga-btn", {
+    variants: {
+        variant: {
+            /* the base button — everything else is this shape plus a colour */
+            secondary: "",
+            /* the one filled thing on a page */
+            primary: "tamga-btn-primary",
+            /* confirming: status colour as an edge, never a fill */
+            success: "tamga-btn-success",
+            /* destructive: findable and deliberate, not loud */
+            danger: "tamga-btn-danger",
+            /* no edge, no offset, no lift — it is not an object on the page */
+            ghost: "tamga-btn-ghost",
+            /* reads as a link, behaves as a button. For a click that runs code but
+               must not compete with the buttons beside it. If it NAVIGATES, use an
+               anchor with .tamga-link instead — a fake link cannot be middle-clicked
+               and misreports itself to a screen reader. */
+            link: "tamga-btn-link",
+        },
+        size: {
+            base: "",
+            /* 32px, for card headers and dense toolbars */
+            sm: "tamga-btn-sm",
+        },
+        full: { true: "w-full", false: "" },
+    },
+    defaultVariants: { variant: "secondary", size: "base", full: false },
+});
+export function Button({ className, variant, size, full, busy = false, busyLabel, children, disabled, ...props }) {
+    return (_jsx("button", { "data-slot": "button", "data-busy": busy || undefined, "aria-busy": busy || undefined, 
+        /* Kilit `disabled` ile: sürerken ikinci bir tıklama olayı hiç doğmuyor.
+           `pointer-events: none` yetmezdi — klavye Enter'ı yine gönderirdi. */
+        disabled: disabled || busy, className: cn(buttonVariants({ variant, size, full }), className), ...props, children: busy ? (_jsxs(_Fragment, { children: [_jsx(Spinner, { size: 16, label: busyLabel ?? "" }), _jsx("span", { className: "invisible", "aria-hidden": true, children: children })] })) : (children) }));
+}
+/* --------------------------- icon button -------------------------- */
+export const iconButtonVariants = cva("tamga-icon-btn", {
+    variants: { size: { base: "", sm: "size-8" } },
+    defaultVariants: { size: "base" },
+});
+/** 40px square. Always needs an aria-label — there is no text to read. */
+export function IconButton({ className, size, "aria-label": label, ...props }) {
+    return (_jsx("button", { "data-slot": "icon-button", "aria-label": label, className: cn(iconButtonVariants({ size }), className), ...props }));
+}
+/** The densest member: 1px at rest, 2px on hover, and its edge turns accent. */
+export function MiniButton({ className, "aria-label": label, ...props }) {
+    return (_jsx("button", { "data-slot": "mini-button", "aria-label": label, className: cn("tamga-mini-btn", className), ...props }));
+}

package/dist/components/chart.d.ts

@@ -0,0 +1,43 @@
+import { type Tone } from "./tone.js";
+/**
+ * Çizgi grafik — eksenli, gerçek grafik.
+ *
+ * Gerekçe: docs/gerekce/03-grafik-ve-olcum.md
+ */
+export type Series = {
+    /**
+     * The line's name; the legend and the screen reader use it. TR: Çizginin adı; legend ve ekran
+     * okuyucu bunu kullanır.
+     */
+    name: string;
+    values: readonly number[];
+    /**
+     * A STATUS tone: for when a line says something good or bad. LEFT OUT, THE CATEGORICAL
+     * PALETTE is used, and that is a correction. Every series without a tone used to fall to
+     * `neutral`: plotting three products' daily sales drew three lines in the SAME faint grey,
+     * with no way to match the legend's names to them. A series is often not a status but a
+     * CATEGORY (product, store, channel), and a category's colour comes from the palette. TR:
+     * DURUM tonu: bir çizgi iyi ya da kötü bir şeyi anlatıyorsa. VERİLMEZSE KATEGORİK PALET
+     * kullanılıyor, ve bu bir düzeltme. Önce ton verilmeyen her seri `neutral`a düşüyordu: üç
+     * ürünün günlük satışını çizdiğinde üç çizgi de AYNI soluk griydi ve legend'daki adları
+     * çizgilere eşleştirmenin hiçbir yolu yoktu. Bir seri çoğu zaman bir durum değil bir
+     * KATEGORİDİR (ürün, mağaza, kanal), ve kategorinin rengi paletten gelir.
+     */
+    tone?: Tone;
+};
+export declare function LineChart({ series, labels, height, formatValue, className, }: {
+    series: readonly Series[];
+    /**
+     * The marks under the X axis. The caller formats the numbers. TR: X ekseninin altındaki
+     * işaretler. Sayıları çağıran biçimlendirir.
+     */
+    labels: readonly string[];
+    height?: number;
+    /**
+     * "24ms", "98%"; the unit comes from the caller, the kit knows no units. TR: "24ms", "%98";
+     * birim çağırandan gelir, kit birim bilmez.
+     */
+    formatValue?: (v: number) => string;
+    className?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=chart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart.d.ts","sourceRoot":"","sources":["../../src/components/chart.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAU,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAE9C;;;;GAIG;AAEH,MAAM,MAAM,MAAM,GAAG;IACnB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;CACb,CAAC;AAcF,wBAAgB,SAAS,CAAC,EACxB,MAAM,EACN,MAAM,EACN,MAAY,EACZ,WAAoB,EACpB,SAAS,GACV,EAAE;IACD,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BA+HA"}

package/dist/components/chart.js

@@ -0,0 +1,41 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId, useState } from "react";
+import { cn } from "../lib/cn.js";
+import { toneOf } from "./tone.js";
+/** Ton verilmemiş serinin rengi: sırayla kategorik palet. */
+function seriRengi(s, i) {
+    return s.tone ? toneOf(s.tone).mark : `var(--color-chart-${(i % 5) + 1})`;
+}
+/** Sayıyı ızgara çizgisine yuvarlar: 87 → 100, 412 → 500. */
+function niceMax(v) {
+    if (v <= 0)
+        return 1;
+    const mag = 10 ** Math.floor(Math.log10(v));
+    return Math.ceil(v / mag) * mag;
+}
+export function LineChart({ series, labels, height = 200, formatValue = String, className, }) {
+    const id = useId();
+    const [hover, setHover] = useState(null);
+    const all = series.flatMap((s) => [...s.values]);
+    const max = niceMax(Math.max(1, ...all));
+    const count = Math.max(...series.map((s) => s.values.length), 1);
+    /* viewBox birim kare: SVG ölçeklenirken çizgi kalınlığı bozulmasın diye
+       `vector-effect` kullanılıyor, koordinatlar yüzde üzerinden. */
+    const W = 100;
+    const H = 100;
+    const x = (i) => (count === 1 ? W / 2 : (i / (count - 1)) * W);
+    const y = (v) => H - (v / max) * H;
+    /* Dört ızgara çizgisi: daha azı okumayı zorlaştırır, daha çoğu grafiği
+       kafese çevirir. */
+    const ticks = [0, 0.25, 0.5, 0.75, 1].map((f) => max * f);
+    return (_jsxs("figure", { className: cn("tamga-surface p-4", className), children: [_jsxs("div", { className: "flex gap-3", children: [_jsx("div", { className: "flex shrink-0 flex-col justify-between text-right font-mono text-caption text-ink-faint tabular-nums", style: { height }, "aria-hidden": true, children: [...ticks].reverse().map((t) => (_jsx("span", { children: formatValue(Math.round(t)) }, t))) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("svg", { viewBox: `0 0 ${W} ${H}`, preserveAspectRatio: "none", style: { height, width: "100%" }, role: "img", "aria-labelledby": id, onMouseLeave: () => setHover(null), children: [_jsx("title", { id: id, children: series.map((s) => `${s.name}: ${formatValue(s.values[s.values.length - 1] ?? 0)}`).join(" · ") }), ticks.map((t) => (_jsx("line", { x1: 0, x2: W, y1: y(t), y2: y(t), stroke: "var(--color-line)", strokeWidth: 1, vectorEffect: "non-scaling-stroke" }, t))), series.map((s, si) => {
+                                        const renk = seriRengi(s, si);
+                                        const d = s.values.map((v, i) => `${i === 0 ? "M" : "L"}${x(i)} ${y(v)}`).join(" ");
+                                        return (_jsx("path", { d: d, fill: "none", stroke: renk, strokeWidth: 2, strokeLinejoin: "round", strokeLinecap: "round", vectorEffect: "non-scaling-stroke" }, s.name));
+                                    }), Array.from({ length: count }, (_, i) => (_jsx("rect", { x: x(i) - W / count / 2, y: 0, width: W / count, height: H, fill: "transparent", onMouseEnter: () => setHover(i) }, i))), hover !== null ? (_jsx("line", { x1: x(hover), x2: x(hover), y1: 0, y2: H, stroke: "var(--color-ink-faint)", strokeWidth: 1, vectorEffect: "non-scaling-stroke" })) : null] }), _jsx("div", { className: "mt-1 flex justify-between font-mono text-caption text-ink-faint", "aria-hidden": true, children: labels.map((l) => (_jsx("span", { children: l }, l))) })] })] }), _jsx("figcaption", { className: "mt-3 flex flex-wrap gap-x-5 gap-y-1", children: series.map((s, si) => {
+                    const renk = seriRengi(s, si);
+                    const v = hover !== null ? s.values[hover] : s.values[s.values.length - 1];
+                    return (_jsxs("span", { className: "flex items-center gap-2 text-small text-ink-soft", children: [_jsx("span", { "aria-hidden": true, className: "h-0.5 w-4", style: { background: renk } }), s.name, _jsx("span", { className: "font-mono text-ink tabular-nums", children: formatValue(v ?? 0) })] }, s.name));
+                }) })] }));
+}

package/dist/components/checkbox.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode } from "react";
+export declare function Checkbox({ label, checked, onChange, disabled, className, }: {
+    /**
+     * The visible label. The kit does not translate; the caller passes ready text. TR: Görünen
+     * etiket. Kit çeviri yapmaz; hazır metni çağıran geçer.
+     */
+    label: ReactNode;
+    checked: boolean;
+    onChange?: (next: boolean) => void;
+    disabled?: boolean;
+    className?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=checkbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox.d.ts","sourceRoot":"","sources":["../../src/components/checkbox.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAavC,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,OAAO,EACP,QAAQ,EACR,QAAgB,EAChB,SAAS,GACV,EAAE;IACD;;;OAGG;IACH,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAkBA"}

package/dist/components/checkbox.js

@@ -0,0 +1,16 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "../lib/cn.js";
+import { Icon } from "./icon.js";
+import { Check } from "./icons.js";
+import { OFF } from "./control-base.js";
+/* ---------------------------------------------------------------- *
+ * Checkbox — bir DEĞER, bir hedef değil.
+ *
+ * İşaretlendiğinde DOLAR. Yasa 2'nin istisnası değil, teyidi: dolgu "bu
+ * seçildi" demiyor, "bu değer açık" diyor. Mini butonun 1px kenarını ve 1px
+ * offsetini taşır, böylece kontrol ailesinin bir üyesi gibi okunur.
+ * ---------------------------------------------------------------- */
+export function Checkbox({ label, checked, onChange, disabled = false, className, }) {
+    return (_jsxs("button", { type: "button", role: "checkbox", "aria-checked": checked, "aria-disabled": disabled || undefined, disabled: disabled, onClick: () => !disabled && onChange?.(!checked), className: cn("flex items-center gap-2 text-body", className), style: disabled ? OFF : undefined, children: [_jsx("span", { className: "tamga-check", "data-checked": checked, children: checked ? _jsx(Icon, { icon: Check, size: "xs", weight: "bold" }) : null }), label] }));
+}

package/dist/components/chrome.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Açık/koyu tema düğmesi.
+ *
+ * SUNUCU TEMAYI BİLMEZ. İlk boyama her zaman açık temayla çıkar ve tercih
+ * `useEffect` içinde uygulanır — yani koyu tema seçmiş biri bir kare boyunca
+ * açık ekran görür. Bunu tamamen çözmenin tek yolu `<head>`'e engelleyici bir
+ * script koymak, ve o script'in yeri KİT DEĞİL uygulamadır: kitin bir
+ * `<head>`'i yoktur.
+ *
+ * `storageKey` bu yüzden bir prop: uygulama aynı anahtarı kendi script'inde
+ * de okuyabilsin diye. İki taraf farklı anahtar kullanırsa tercih sessizce
+ * kaybolur.
+ *
+ * Metinler dışarıdan geliyor. Kit çeviri yapmaz — ve bir düğmenin adı, içinde
+ * metin olmadığı için erişilebilirliğin tamamıdır.
+ *
+ * İKİ BİÇİM, VE SEBEBİ ORANTI. `icon` sıkışık bir araç çubuğuna girer: 40×40,
+ * tek simge. Ama yanında bir dil anahtarı gibi ANAHTAR biçimli bir kontrol
+ * varsa, kare düğme onun iki katı yüksekliğinde durur ve şerit dengesiz
+ * görünür. `switch` biçimi aynı iskeleti kullanıyor — iki uçta birer simge,
+ * ortada kayan bir anahtar — yani ikisi yan yana aynı satırda oturuyor.
+ */
+export declare function ThemeToggle({ labels, variant, storageKey, className, }: {
+    labels: {
+        toLight: string;
+        toDark: string;
+    };
+    /**
+     * `icon` a square button · `switch` the same shape as a language toggle. TR: `icon` kare
+     * düğme · `switch` bir dil anahtarıyla aynı şekil.
+     */
+    variant?: "icon" | "switch";
+    storageKey?: string;
+    className?: string;
+}): import("react").JSX.Element;
+/**
+ * Dil değiştirici.
+ *
+ * Kit YÖNLENDİRME YAPMAZ. `onChange` seçilen dili verir; nereye gidileceği —
+ * `router.push`, tam sayfa yenileme, bir çerez yazıp yeniden yükleme —
+ * uygulamanın kararı ve yönlendiricisine bağlı. Kitin `next/navigation`'a
+ * bağlanması, onu bir framework'e bağlamak olurdu.
+ *
+ * Etiketler ENDONİM olmalı: "English", "İngilizce" değil. Bir dili arayan
+ * kişi onu kendi dilinde arar. Kit bunu zorlayamaz ama doküman söyler.
+ *
+ * İki dilde SEGMENTED, üç ve fazlasında SELECT — kendiliğinden. İki seçenek
+ * yan yana sığar ve tek tıkla değişir; beş dil yan yana konursa üst şeridi
+ * doldurur ve altıncı dilde taşar.
+ */
+export declare function LocaleSwitcher({ locales, current, onChange, label, className, }: {
+    /**
+     * `[{ value: "tr", label: "Türkçe" }, …]`: the labels are endonyms. TR: `[{ value: "tr",
+     * label: "Türkçe" }, …]`: etiketler endonim.
+     */
+    locales: readonly {
+        value: string;
+        label: string;
+    }[];
+    current: string;
+    onChange: (next: string) => void;
+    /** The control's name: "Dil", "Language". TR: Kontrolün adı: "Dil", "Language". */
+    label: string;
+    className?: string;
+}): import("react").JSX.Element;
+/**
+ * Kare marka karosu.
+ *
+ * Bir logonun etrafındaki kutu. Görsel yoksa baş harf — `Avatar`'la aynı
+ * gerekçe: gri bir yer tutucu hiçbir şeyi temsil etmez, bir harf gerçekten o
+ * şeyi işaret eder.
+ *
+ * `alt` boş bırakılıyor ve bu bilinçli: karo neredeyse her zaman adı YANINDA
+ * yazan bir şeyin yanında durur. İkisini de okutmak ekran okuyucuda adı iki
+ * kez tekrarlar.
+ */
+export declare function LogoTile({ name, src, size, className, }: {
+    /**
+     * The initial is built from it, and it is what shows when the image does not load. TR: Baş
+     * harf buradan üretilir; görsel yüklenmezse görünen şey bu.
+     */
+    name: string;
+    src?: string;
+    size?: "base" | "sm";
+    className?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=chrome.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.d.ts","sourceRoot":"","sources":["../../src/components/chrome.tsx"],"names":[],"mappings":"AA8BA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,OAAgB,EAChB,UAA0B,EAC1B,SAAS,GACV,EAAE;IACD,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAmDA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,OAAO,EACP,QAAQ,EACR,KAAK,EACL,SAAS,GACV,EAAE;IACD;;;OAGG;IACH,OAAO,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAgCA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,GAAG,EACH,IAAa,EACb,SAAS,GACV,EAAE;IACD;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAaA"}

package/dist/components/chrome.js

@@ -0,0 +1,107 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { cn } from "../lib/cn.js";
+import { Icon } from "./icon.js";
+import { Switch } from "./switch.js";
+import { ThemeDark, ThemeLight } from "./icons.js";
+/**
+ * Kabuk parçaları.
+ *
+ * Gerekçe: docs/gerekce/05-yuzey-ve-kabuk.md
+ */
+/** Tarayıcı depolaması patlayabilir (özel pencere, kapalı site verisi). */
+function read(key) {
+    try {
+        return localStorage.getItem(key);
+    }
+    catch {
+        return null;
+    }
+}
+function write(key, value) {
+    try {
+        localStorage.setItem(key, value);
+    }
+    catch {
+        /* tercih hatırlanmaz, sayfa yine çalışır */
+    }
+}
+/**
+ * Açık/koyu tema düğmesi.
+ *
+ * SUNUCU TEMAYI BİLMEZ. İlk boyama her zaman açık temayla çıkar ve tercih
+ * `useEffect` içinde uygulanır — yani koyu tema seçmiş biri bir kare boyunca
+ * açık ekran görür. Bunu tamamen çözmenin tek yolu `<head>`'e engelleyici bir
+ * script koymak, ve o script'in yeri KİT DEĞİL uygulamadır: kitin bir
+ * `<head>`'i yoktur.
+ *
+ * `storageKey` bu yüzden bir prop: uygulama aynı anahtarı kendi script'inde
+ * de okuyabilsin diye. İki taraf farklı anahtar kullanırsa tercih sessizce
+ * kaybolur.
+ *
+ * Metinler dışarıdan geliyor. Kit çeviri yapmaz — ve bir düğmenin adı, içinde
+ * metin olmadığı için erişilebilirliğin tamamıdır.
+ *
+ * İKİ BİÇİM, VE SEBEBİ ORANTI. `icon` sıkışık bir araç çubuğuna girer: 40×40,
+ * tek simge. Ama yanında bir dil anahtarı gibi ANAHTAR biçimli bir kontrol
+ * varsa, kare düğme onun iki katı yüksekliğinde durur ve şerit dengesiz
+ * görünür. `switch` biçimi aynı iskeleti kullanıyor — iki uçta birer simge,
+ * ortada kayan bir anahtar — yani ikisi yan yana aynı satırda oturuyor.
+ */
+export function ThemeToggle({ labels, variant = "icon", storageKey = "tamga-theme", className, }) {
+    const [dark, setDark] = useState(false);
+    useEffect(() => {
+        const saved = read(storageKey);
+        const initial = saved
+            ? saved === "dark"
+            : window.matchMedia("(prefers-color-scheme: dark)").matches;
+        setDark(initial);
+        document.documentElement.classList.toggle("dark", initial);
+    }, [storageKey]);
+    function toggle() {
+        const next = !dark;
+        setDark(next);
+        document.documentElement.classList.toggle("dark", next);
+        write(storageKey, next ? "dark" : "light");
+    }
+    if (variant === "switch") {
+        return (_jsxs("span", { className: cn("flex items-center gap-2", className), children: [_jsx(Icon, { icon: ThemeLight, size: "xs", "aria-hidden": true, className: dark ? "text-ink-faint" : "text-ink" }), _jsx(Switch, { on: dark, onChange: toggle, label: dark ? labels.toLight : labels.toDark }), _jsx(Icon, { icon: ThemeDark, size: "xs", "aria-hidden": true, className: dark ? "text-ink" : "text-ink-faint" })] }));
+    }
+    return (_jsx("button", { type: "button", onClick: toggle, className: cn("tamga-icon-btn", className), "aria-label": dark ? labels.toLight : labels.toDark, children: _jsx(Icon, { icon: dark ? ThemeLight : ThemeDark, size: "sm" }) }));
+}
+/**
+ * Dil değiştirici.
+ *
+ * Kit YÖNLENDİRME YAPMAZ. `onChange` seçilen dili verir; nereye gidileceği —
+ * `router.push`, tam sayfa yenileme, bir çerez yazıp yeniden yükleme —
+ * uygulamanın kararı ve yönlendiricisine bağlı. Kitin `next/navigation`'a
+ * bağlanması, onu bir framework'e bağlamak olurdu.
+ *
+ * Etiketler ENDONİM olmalı: "English", "İngilizce" değil. Bir dili arayan
+ * kişi onu kendi dilinde arar. Kit bunu zorlayamaz ama doküman söyler.
+ *
+ * İki dilde SEGMENTED, üç ve fazlasında SELECT — kendiliğinden. İki seçenek
+ * yan yana sığar ve tek tıkla değişir; beş dil yan yana konursa üst şeridi
+ * doldurur ve altıncı dilde taşar.
+ */
+export function LocaleSwitcher({ locales, current, onChange, label, className, }) {
+    if (locales.length <= 2) {
+        return (_jsx("span", { className: cn("tamga-segment", className), role: "group", "aria-label": label, children: locales.map((l) => (_jsx("button", { type: "button", "data-active": l.value === current, "aria-current": l.value === current ? "true" : undefined, onClick: () => onChange(l.value), children: l.label }, l.value))) }));
+    }
+    return (_jsx("select", { className: cn("tamga-input h-9 w-auto", className), "aria-label": label, value: current, onChange: (e) => onChange(e.target.value), children: locales.map((l) => (_jsx("option", { value: l.value, children: l.label }, l.value))) }));
+}
+/**
+ * Kare marka karosu.
+ *
+ * Bir logonun etrafındaki kutu. Görsel yoksa baş harf — `Avatar`'la aynı
+ * gerekçe: gri bir yer tutucu hiçbir şeyi temsil etmez, bir harf gerçekten o
+ * şeyi işaret eder.
+ *
+ * `alt` boş bırakılıyor ve bu bilinçli: karo neredeyse her zaman adı YANINDA
+ * yazan bir şeyin yanında durur. İkisini de okutmak ekran okuyucuda adı iki
+ * kez tekrarlar.
+ */
+export function LogoTile({ name, src, size = "base", className, }) {
+    return (_jsx("span", { className: cn("tamga-logo-tile", size === "sm" && "tamga-logo-tile-sm", className), children: src ? (_jsx("img", { src: src, alt: "", className: "h-full w-full object-contain p-1.5" })) : (_jsx("span", { "aria-hidden": true, className: "font-mono text-subhead font-semibold text-ink-faint", children: name.trim().charAt(0).toLocaleUpperCase() })) }));
+}

package/dist/components/combobox.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Combobox — aranabilir seçim.
+ *
+ * Gerekçe: docs/gerekce/01-form-ve-girdi.md
+ */
+export type ComboOption<T extends string> = {
+    value: T;
+    label: string;
+    /** Etiketin altındaki ikinci satır — SKU, e-posta, kategori. */
+    hint?: string;
+};
+export declare function Combobox<T extends string>({ options, value, onChange, onSearch, placeholder, labels, disabled, invalid, className, }: {
+    options: readonly ComboOption<T>[];
+    value?: T;
+    onChange?: (next: T | undefined) => void;
+    /**
+     * Given, filtering happens ON THE SERVER; the kit shows the list it receives as it is. TR:
+     * Verilirse süzme SUNUCUDA yapılır; kit gelen listeyi olduğu gibi gösterir.
+     */
+    onSearch?: (query: string) => void;
+    placeholder: string;
+    labels: {
+        empty: string;
+        clear: string;
+        open: string;
+    };
+    disabled?: boolean;
+    invalid?: boolean;
+    className?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=combobox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../src/components/combobox.tsx"],"names":[],"mappings":"AAOA;;;;GAIG;AAEH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,IAAI;IAC1C,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,EACzC,OAAO,EACP,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,MAAM,EACN,QAAgB,EAChB,OAAe,EACf,SAAS,GACV,EAAE;IACD,OAAO,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAwIA"}