@mesgflow/ui-kit 0.6.0

package/types/mesgflow-ui-kit-core.d.ts

@@ -0,0 +1,508 @@
+import { ClassValue } from 'clsx';
+import { ConnectedPosition } from '@angular/cdk/overlay';
+import * as _mesgflow_ui_kit_core from '@mesgflow/ui-kit/core';
+import { InjectionToken, Signal, EnvironmentProviders } from '@angular/core';
+import { Locale } from 'date-fns/locale';
+
+/** clsx ile koşullu class'ları birleştirir, tailwind-merge ile çakışan utility'leri (ör. iki farklı `bg-*`) sonuncusu kazanacak şekilde çözer. */
+declare function cn(...inputs: ClassValue[]): string;
+
+/**
+ * Yazı yönü yardımcıları — `dir="rtl"` (öğede ya da bir atada) ya da CSS `direction` kalıtımı.
+ * Hesaplanan stil okunur: yön bir atadan gelse de doğru sonuç verir. SSR'de (stil yok) LTR.
+ */
+declare function isRtl(el: Element): boolean;
+/** İşaretçinin satır başından (LTR'de sol, RTL'de sağ kenar) oranı, 0–1 aralığına kırpılmış. */
+declare function inlineStartRatio(clientX: number, rect: DOMRect, rtl: boolean): number;
+/**
+ * Yatay kaydırmanın başlangıçtan uzaklığı. Modern tarayıcılarda RTL'de `scrollLeft` 0'dan
+ * NEGATİFE gider (başlangıç = 0, son = −max); mutlak değer iki yönde de "başlangıçtan uzaklık".
+ */
+declare function scrollFromInlineStart(el: Element): number;
+
+/**
+ * Kit genelinde paylaşılan primitif tipler — her bileşenin kendi `size`/`tone`
+ * union'ını elle tekrar tanımlamak yerine buradan türetir. Bkz. plan dosyası
+ * "Faz 1a" — `tone` kelime dağarcığının (severity/tone/type karmaşasının)
+ * birleştiği tek kaynak burası olacak.
+ */
+type MfSize = 'sm' | 'md' | 'lg';
+type MfTone = 'neutral' | 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'help';
+type MfPlacement = 'top' | 'bottom' | 'left' | 'right' | 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
+
+/**
+ * Paylaşılan class reçeteleri — kontrol/overlay/kapsayıcı bileşenlerinin
+ * TEKRAR TEKRAR yazdığı focus/disabled/boyut/yüzey kalıplarının TEK kaynağı
+ * (bkz. plan Faz 1a/1b). Öncesinde 5 farklı disabled reçetesi, 4 farklı
+ * focus-offset kombinasyonu ve 9 elle yazılmış `h-8`/`h-9`/`h-10` sabiti
+ * vardı — her biri kendi kopyasını sürüklüyordu (gerçek bulgu). Bileşenler
+ * bunları `cn()` ile kendi özel class'larıyla birleştirir (`cn()` twMerge
+ * kullandığı için çakışan Tailwind utility'leri güvenle çözülür).
+ */
+/** `outline`+`outline-offset` tabanlı TEK focus mekanizması — bkz. `button.variants.ts`'in "Focus — tek mekanizma" notu. Box-shadow/ring KULLANMA. */
+declare const focusRecipe = "focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-ring";
+/** Native `disabled` VE `aria-disabled` (ör. `@angular/aria` desenlerinin kullandığı) ikisini de kapsar — bkz. plan "Disabled 5 farklı reçete" bulgusu. */
+declare const disabledRecipe = "disabled:pointer-events-none disabled:opacity-50 disabled:shadow-none aria-disabled:pointer-events-none aria-disabled:opacity-50";
+/** Input/Select/Combobox/NumberInput/... — tüm form kontrollerinin ortak kabuğu. `shadow-control` (bkz. elevation.css) — `shadow-1` DEĞİL, kontroller kapsayıcılarla AYNI yükselti basamağını paylaşmaz. */
+declare const controlSurface = "rounded-md border border-border bg-surface text-fg shadow-control transition-colors duration-fast ease-emphasis hover:border-border-strong focus-within:border-accent";
+/** `size: MfSize` eksenindeki TÜM kontrollerin ortak yükseklik/dolgu/font eşlemesi — bkz. `radius.css`'teki `--control-h-*` token'ları. */
+declare const controlSize: Record<MfSize, string>;
+/**
+ * Popover/Menu/Select/Combobox/... overlay panellerinin ortak kabuğu — BORDER-
+ * FIRST (2026-09 Deep Emerald geçişi, kullanıcı kararıyla eski "light modda
+ * kenarlıksız, sadece gölge" ilkesinin YERİNE geçti): iki modda da
+ * `border-hairline` (color.css — %8-12 opak marka-tonlu 1px çizgi) + `shadow-2`.
+ * Ağır/bulanık gölge yerine ince çizgi "premium" hissi artık BÖYLE veriliyor.
+ */
+declare const overlaySurface = "rounded-lg border border-hairline bg-overlay shadow-2";
+/** Card/Table/StatTile gibi statik kapsayıcıların ortak kabuğu — BORDER-FIRST: iki modda da gölgesiz, sadece `border-hairline` (bkz. `overlaySurface`'in aynı gerekçesi). */
+declare const containerSurface = "rounded-lg border border-hairline bg-surface";
+/**
+ * Mikro glassmorphism — Dialog/Sheet/Drawer paneli ve Toast öğeleri (bkz.
+ * `dialog.variants.ts`, `toast-host.ts`) bunu kullanır. `supports-[…]` ile
+ * `backdrop-filter` desteklenmediğinde düz `bg-surface`'e düşer (eski
+ * tarayıcı/headless test ortamı); `reduced-transparency:` (color.css'te
+ * tanımlı custom variant, `prefers-reduced-transparency: reduce` medya
+ * sorgusu) kullanıcı saydamlığı azalt istediğinde camı KAPATIR — WCAG 1.4.11
+ * "Non-text Contrast" ve hareket/saydamlık duyarlılığı için. Tüketici kendi
+ * `border`/`rounded-*` genişliğini üstüne ekler.
+ */
+declare const glassSurface = "border-hairline bg-surface supports-[backdrop-filter]:bg-glass supports-[backdrop-filter]:backdrop-blur-md reduced-transparency:bg-surface reduced-transparency:backdrop-blur-none";
+/** `hasError`/`aria-invalid` durumundaki form kontrolleri için — `controlSurface` İLE BİRLİKTE, üstüne eklenir. */
+declare const errorRecipe = "border-danger focus-within:border-danger focus-visible:outline-danger";
+/**
+ * Renk/gölge geçişlerinin TEK hareket dili — `ease-emphasis` kitin kendi eğrisi
+ * (bkz. `motion.css`), tarayıcı varsayılanı `ease` DEĞİL. Öncesinde ~35 yerde
+ * `transition-colors duration-fast` easing'siz kullanılıyordu (gerçek bulgu,
+ * bkz. plan Faz 1c).
+ */
+declare const transitionRecipe = "transition-colors duration-fast ease-emphasis";
+/** Basılı-hissi — `active:scale` ekseninde TEK reçete, disabled'da sıfırlanır. */
+declare const pressRecipe = "active:scale-[0.99] disabled:active:scale-100";
+
+/**
+ * Bileşen örneği başına kararlı, benzersiz bir DOM id'si üretir —
+ * `aria-controls`/`aria-describedby`/`aria-activedescendant` gibi bağların
+ * her component klasöründe kendi elle sayaçlarını (bkz. `combobox.ts`'teki
+ * `comboboxIdSeq` — bu modül kullanıma girince oraya taşınacak) tekrar
+ * yazmasına gerek kalmasın diye. SSR'da hydration uyuşmazlığı YARATMAZ —
+ * her platformda modül yüklendiğinde sıfırdan başlar, sayaç deterministik.
+ */
+declare function nextId(prefix: string): string;
+
+/**
+ * `registerOnChange`/`registerOnTouched`'ın HER `ControlValueAccessor`
+ * implementasyonunda BİREBİR aynı kalan gövdesini tek kaynağa indirger
+ * (bkz. Select/NumberInput/Combobox/ColorPicker'ın öncesi — 4+ kopya, plan
+ * Faz 2 "CVA tamamlama" notu). Alt sınıf SADECE `writeValue`'yu (kendi
+ * `model`/`signal`'ına yazan) tanımlar VE kendi `NG_VALUE_ACCESSOR`
+ * provider'ını `@Component`'ında bildirir — `forwardRef(() => AltSınıf)`
+ * somut sınıfa ihtiyaç duyduğu için provider MİRAS ALINAMAZ.
+ *
+ * Düz bir soyut sınıf (Angular `@Directive()` DEĞİL) — `inject()` ya da
+ * yaşam döngüsü kancası kullanmıyor, sadece alan/metot mirası; `@Directive()`
+ * sarmalamak gereksiz karmaşıklık olurdu.
+ */
+declare abstract class ValueAccessorBase<T> {
+    protected onChange: (value: T) => void;
+    protected onTouched: () => void;
+    registerOnChange(fn: (value: T) => void): void;
+    registerOnTouched(fn: () => void): void;
+}
+
+/**
+ * `Popover`'ın (`PLACEMENTS`) ve `Tooltip`'in (`POSITIONS`) kendi dosyalarında
+ * ayrı ayrı tuttuğu CDK `ConnectedPosition[]` çiftlerinin ORTAK geometri
+ * üretici hâli — 8 yerleşimin (4 köşe + 4 kenar) hepsini tek bir fonksiyonla
+ * üretir, `offset` çağıranın KENDİ mevcut değerini (Popover 4px, Tooltip 8px,
+ * diğer overlay'ler 4-8px arası değişen) korumasını sağlar.
+ *
+ * Bu modül BİLEREK henüz hiçbir bileşene BAĞLANMADI (Faz 0c) — `Popover`,
+ * `Tooltip` ve 10 kopya `ConnectedPosition[]` içeren diğer bileşenlerin buna
+ * geçişi Faz 1c'nin ("Overlay birleştirme") kapsamı: her biri kendi klavye/
+ * vurgu mantığını koruyarak taşınmalı ve tarayıcıda tek tek doğrulanmalı —
+ * bu fazın (yapısal taşıma) riskiyle karıştırılmamalı.
+ */
+declare function overlayPositions(placement: MfPlacement, offset?: number): ConnectedPosition[];
+
+/**
+ * Kitin TÜM metinlerinin TEK şekli — `MF_LABELS` injection token'ının taşıdığı
+ * tip (bkz. `tokens.ts`). Her alt-nesne bir bileşen ailesinin metinlerini
+ * gruplar (Dialog'un önceki `MfDialogLabels`'ı ve DatePicker/Table'ın "grup
+ * input" çantalarıyla AYNI emsal — tek fark artık HEPSİ tek bir kökten
+ * `provideMesgflowUi()` ile sağlanıyor, bkz. `provide.ts`).
+ */
+interface MfCommonLabels {
+    loading: string;
+    clear: string;
+    remove: string;
+}
+interface MfDialogLabels {
+    close: string;
+    resize: string;
+    fullscreenEnter: string;
+    fullscreenExit: string;
+    confirmOk: string;
+    confirmCancel: string;
+    confirmConfirm: string;
+    confirmDelete: string;
+    errorGeneric: string;
+    discard: {
+        title: string;
+        content: string;
+        confirm: string;
+        cancel: string;
+    };
+}
+interface MfDatePickerLabels {
+    today: string;
+    clear: string;
+    apply: string;
+    previousMonth: string;
+    nextMonth: string;
+    previousYear: string;
+    nextYear: string;
+    chooseMonth: string;
+    chooseYear: string;
+    startDate: string;
+    endDate: string;
+    placeholder: string;
+    presetToday: string;
+    presetLast7: string;
+    presetLast30: string;
+    presetThisMonth: string;
+}
+interface MfTimePickerLabels {
+    placeholder: string;
+    clear: string;
+}
+interface MfTableFilterOperatorLabels {
+    equal: string;
+    notEqual: string;
+    greaterThan: string;
+    greaterOrEqual: string;
+    lessThan: string;
+    lessOrEqual: string;
+    contains: string;
+    startsWith: string;
+    endsWith: string;
+    in: string;
+    isNull: string;
+    isNotNull: string;
+    between: string;
+}
+interface MfTableFilterLabels {
+    addFilter: string;
+    searchField: string;
+    noField: string;
+    operator: string;
+    value: string;
+    apply: string;
+    enterHint: string;
+    clearAll: string;
+    and: string;
+    or: string;
+    remove: string;
+    back: string;
+    dateToday: string;
+    dateLast7: string;
+    dateLast30: string;
+    dateThisMonth: string;
+    dateCustom: string;
+    dateFrom: string;
+    dateTo: string;
+    operators: MfTableFilterOperatorLabels;
+}
+interface MfTablePaginationLabels {
+    records: string;
+    perPage: string;
+    page: string;
+    previous: string;
+    next: string;
+    first: string;
+    last: string;
+    pageSizeAriaLabel: string;
+    navAriaLabel: string;
+    jumpToPage: string;
+    go: string;
+}
+interface MfTableLabels {
+    searchPlaceholder: string;
+    selectedCount: string;
+    edit: string;
+    delete: string;
+    clearSelection: string;
+    emptyTitle: string;
+    emptyDescription: string;
+    noResultsTitle: string;
+    noResultsDescription: string;
+    clearFilters: string;
+    filterCount: string;
+    selectAllAriaLabel: string;
+    selectRowAriaLabel: string;
+    actionsColumnLabel: string;
+    columns: string;
+    density: string;
+    densityComfortable: string;
+    densityCompact: string;
+    resizeColumn: string;
+    expandRow: string;
+    collapseRow: string;
+    filter: MfTableFilterLabels;
+    pagination: MfTablePaginationLabels;
+}
+interface MfSidebarLabels {
+    collapse: string;
+    expand: string;
+    switchTenant: string;
+    noTenants: string;
+    noUser: string;
+    nav: string;
+}
+interface MfTabsLabels {
+    scrollStart: string;
+    scrollEnd: string;
+    close: string;
+}
+interface MfDropzoneLabels {
+    label: string;
+}
+interface MfColorPickerLabels {
+    ariaLabel: string;
+    hexAriaLabel: string;
+    pickFromScreenAriaLabel: string;
+}
+interface MfBoxInputLabels {
+    top: string;
+    right: string;
+    bottom: string;
+    left: string;
+    linkSides: string;
+    unlinkSides: string;
+}
+interface MfComboboxLabels {
+    placeholder: string;
+    noResults: string;
+}
+interface MfSelectLabels {
+    placeholder: string;
+}
+interface MfSearchInputLabels {
+    placeholder: string;
+    ariaLabel: string;
+    clearAriaLabel: string;
+}
+interface MfToastLabels {
+    dismiss: string;
+}
+interface MfOtpInputLabels {
+    ariaLabel: string;
+}
+interface MfStepperLabels {
+    ariaLabel: string;
+}
+interface MfProgressLabels {
+    ariaLabel: string;
+}
+interface MfPasswordInputLabels {
+    show: string;
+    hide: string;
+}
+interface MfChipLabels {
+    remove: string;
+}
+interface MfAlertLabels {
+    dismiss: string;
+}
+interface MfBreadcrumbLabels {
+    ariaLabel: string;
+}
+interface MfAvatarGroupLabels {
+    /** "+N" göstergesinin aria-label'ı — `overflowCount() + ' ' + overflowAriaLabel`. */
+    overflowAriaLabel: string;
+}
+/** Grafik ailesi (LineChart/Sparkline) — tablo görünümü anahtarı (grafiğin erişilebilir ikizi) ve tablonun ilk sütun başlığı. */
+/** Ağaçtan seçim (`mf-tree-select`). */
+interface MfTreeSelectLabels {
+    placeholder: string;
+    searchPlaceholder: string;
+    noResults: string;
+}
+/** Açık/koyu/sistem değiştirici (`mf-theme-switcher`). */
+interface MfThemeSwitcherLabels {
+    ariaLabel: string;
+    light: string;
+    dark: string;
+    system: string;
+}
+/** Puanlama — `outOf` iki sayının ARASINA yazılır ("3 out of 5"). */
+interface MfRatingLabels {
+    ariaLabel: string;
+    outOf: string;
+}
+/** Ürün turu — `stepOf` iki sayının ARASINA yazılır ("2 of 5"). */
+interface MfTourLabels {
+    next: string;
+    back: string;
+    skip: string;
+    done: string;
+    stepOf: string;
+}
+/** Bağımsız sayfalama (`mf-pagination`) — `page` sayının ÖNÜNE yazılır ("Page 3"). */
+interface MfPaginationLabels {
+    navAriaLabel: string;
+    previous: string;
+    next: string;
+    first: string;
+    last: string;
+    page: string;
+}
+/** Kopyala düğmesi + kod bloğu (`code` = kaydırılabilir kod bölgesinin erişilebilir adı). */
+interface MfCopyLabels {
+    copy: string;
+    copied: string;
+    failed: string;
+    code: string;
+}
+/** Karakter sayacı — sayıların ARDINA yazılır ("12 characters remaining"). */
+interface MfCharacterCountLabels {
+    remaining: string;
+    overLimit: string;
+    characters: string;
+}
+/** Komut paleti (`mf-command`) — `resultsCount` sayının ARDINA yazılır ("8 results"). */
+interface MfCommandLabels {
+    placeholder: string;
+    ariaLabel: string;
+    empty: string;
+    resultsCount: string;
+    navigate: string;
+    select: string;
+    close: string;
+}
+interface MfChartLabels {
+    showTable: string;
+    showChart: string;
+    category: string;
+}
+interface MfLabels {
+    common: MfCommonLabels;
+    dialog: MfDialogLabels;
+    datePicker: MfDatePickerLabels;
+    timePicker: MfTimePickerLabels;
+    table: MfTableLabels;
+    sidebar: MfSidebarLabels;
+    tabs: MfTabsLabels;
+    dropzone: MfDropzoneLabels;
+    colorPicker: MfColorPickerLabels;
+    boxInput: MfBoxInputLabels;
+    combobox: MfComboboxLabels;
+    select: MfSelectLabels;
+    searchInput: MfSearchInputLabels;
+    toast: MfToastLabels;
+    otpInput: MfOtpInputLabels;
+    stepper: MfStepperLabels;
+    progress: MfProgressLabels;
+    passwordInput: MfPasswordInputLabels;
+    chip: MfChipLabels;
+    alert: MfAlertLabels;
+    breadcrumb: MfBreadcrumbLabels;
+    avatarGroup: MfAvatarGroupLabels;
+    chart: MfChartLabels;
+    command: MfCommandLabels;
+    characterCount: MfCharacterCountLabels;
+    copy: MfCopyLabels;
+    pagination: MfPaginationLabels;
+    tour: MfTourLabels;
+    rating: MfRatingLabels;
+    themeSwitcher: MfThemeSwitcherLabels;
+    treeSelect: MfTreeSelectLabels;
+}
+/** `provideMesgflowUi({ labels })`'ın kabul ettiği şekil — her alt-alan opsiyonel, verilmeyen her yaprak `mfLabelsEn`'den gelir. */
+type DeepPartial<T> = T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+/** `base`'i `override`'daki tanımlı yapraklarla değiştirir — dizi yok, her düğüm ya iç içe nesne ya string, sığ `Object.assign` yerine gerçek derin birleştirme gerekiyor (bkz. `provide.ts`). Generic'i `Record<string, unknown>`'a KISITLAMIYOR BİLEREK — `MfLabels` gibi index-signature'ı olmayan named interface'ler o kısıtla uyuşmuyor (bkz. TS2345), bunun yerine iç kısımda cast ediliyor. */
+declare function mergeLabels<T>(base: T, override: DeepPartial<T> | undefined): T;
+
+/**
+ * `MF_LABELS`'ın varsayılan değeri — hiçbir `provideMesgflowUi()` çağrısı
+ * olmayan bir tüketici uygulamada bileşenler bu İngilizce metinlerle çalışır
+ * (bkz. CLAUDE.md/plan kararı: "bileşen varsayılan metinleri İngilizce").
+ * Türkçe çeviri kümesi için bkz. `@mesgflow/ui-kit/i18n/tr`'nin `mfLabelsTr`'si —
+ * bu iki dosya AYNI şekli (bkz. `labels.ts`), farklı değerleri taşır.
+ */
+declare const mfLabelsEn: MfLabels;
+
+/**
+ * Kitin TEK metin kaynağı — `provideMesgflowUi()` (bkz. `provide.ts`)
+ * `provide` etmezse tüketici İngilizce varsayılanlarla çalışır (ng-zorro'nun
+ * `NZ_I18N`'i / PrimeNG'nin `providePrimeNG` config'iyle aynı desen — bu kit
+ * daha önce sadece Dialog için uyguluyordu, `MF_DIALOG_LABELS` artık bu
+ * token'dan türeyen bir "seçici" — bkz. aşağıdaki `labelToken`).
+ */
+declare const MF_LABELS: InjectionToken<Signal<MfLabels>>;
+/** Calendar/DatePicker'ın ay/gün adları için — varsayılan `enUS`, `provideMesgflowUi({ dateLocale })` ile değiştirilir. */
+declare const MF_DATE_LOCALE: InjectionToken<Signal<Locale>>;
+declare const MF_COMMON_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfCommonLabels>>;
+declare const MF_DIALOG_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfDialogLabels>>;
+declare const MF_DATE_PICKER_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfDatePickerLabels>>;
+declare const MF_TIME_PICKER_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfTimePickerLabels>>;
+declare const MF_TABLE_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfTableLabels>>;
+declare const MF_SIDEBAR_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfSidebarLabels>>;
+declare const MF_TABS_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfTabsLabels>>;
+declare const MF_DROPZONE_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfDropzoneLabels>>;
+declare const MF_COLOR_PICKER_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfColorPickerLabels>>;
+declare const MF_BOX_INPUT_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfBoxInputLabels>>;
+declare const MF_COMBOBOX_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfComboboxLabels>>;
+declare const MF_SELECT_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfSelectLabels>>;
+declare const MF_SEARCH_INPUT_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfSearchInputLabels>>;
+declare const MF_TOAST_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfToastLabels>>;
+declare const MF_OTP_INPUT_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfOtpInputLabels>>;
+declare const MF_STEPPER_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfStepperLabels>>;
+declare const MF_PROGRESS_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfProgressLabels>>;
+declare const MF_PASSWORD_INPUT_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfPasswordInputLabels>>;
+declare const MF_CHIP_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfChipLabels>>;
+declare const MF_ALERT_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfAlertLabels>>;
+declare const MF_BREADCRUMB_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfBreadcrumbLabels>>;
+declare const MF_AVATAR_GROUP_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfAvatarGroupLabels>>;
+declare const MF_CHART_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfChartLabels>>;
+declare const MF_COMMAND_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfCommandLabels>>;
+declare const MF_CHARACTER_COUNT_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfCharacterCountLabels>>;
+declare const MF_COPY_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfCopyLabels>>;
+declare const MF_PAGINATION_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfPaginationLabels>>;
+declare const MF_TOUR_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfTourLabels>>;
+declare const MF_RATING_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfRatingLabels>>;
+declare const MF_THEME_SWITCHER_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfThemeSwitcherLabels>>;
+declare const MF_TREE_SELECT_LABELS: InjectionToken<Signal<_mesgflow_ui_kit_core.MfTreeSelectLabels>>;
+
+interface ProvideMesgflowUiOptions {
+    /**
+     * `mfLabelsEn`'in üstüne yazılacak alanlar — ya sabit bir `DeepPartial<MfLabels>`
+     * (ör. `mfLabelsTr`, bkz. `@mesgflow/ui-kit/i18n/tr`) ya da tüketicinin kendi
+     * i18n sistemine bağlı, dil değişince CANLI güncellenen bir `Signal`. Her
+     * iki durumda da verilmeyen her yaprak `mfLabelsEn`'den gelir — TAM bir
+     * `MfLabels` nesnesi sağlamak ZORUNLU değil.
+     */
+    labels?: DeepPartial<MfLabels> | Signal<DeepPartial<MfLabels>>;
+    /** Calendar/DatePicker ay/gün adları — varsayılan `date-fns/locale`'in `enUS`'u. */
+    dateLocale?: Locale;
+}
+/**
+ * `app.config.ts`'in `providers` dizisine eklenir — `MF_LABELS`/`MF_DATE_LOCALE`'ı
+ * (ve bunlardan türeyen `MF_DIALOG_LABELS`/`MF_TABLE_LABELS`/… seçici
+ * token'larını, bkz. `tokens.ts`) tüketicinin verdiği değerlerle sağlar.
+ * Hiç çağrılmazsa kit İngilizce varsayılanlarla (`mfLabelsEn`, `enUS`) çalışır.
+ *
+ * ```ts
+ * import { provideMesgflowUi } from '@mesgflow/ui-kit';
+ * import { mfLabelsTr } from '@mesgflow/ui-kit/i18n/tr';
+ * import { tr } from 'date-fns/locale';
+ *
+ * providers: [provideMesgflowUi({ labels: mfLabelsTr, dateLocale: tr })]
+ * ```
+ */
+declare function provideMesgflowUi(options?: ProvideMesgflowUiOptions): EnvironmentProviders;
+
+export { MF_ALERT_LABELS, MF_AVATAR_GROUP_LABELS, MF_BOX_INPUT_LABELS, MF_BREADCRUMB_LABELS, MF_CHARACTER_COUNT_LABELS, MF_CHART_LABELS, MF_CHIP_LABELS, MF_COLOR_PICKER_LABELS, MF_COMBOBOX_LABELS, MF_COMMAND_LABELS, MF_COMMON_LABELS, MF_COPY_LABELS, MF_DATE_LOCALE, MF_DATE_PICKER_LABELS, MF_DIALOG_LABELS, MF_DROPZONE_LABELS, MF_LABELS, MF_OTP_INPUT_LABELS, MF_PAGINATION_LABELS, MF_PASSWORD_INPUT_LABELS, MF_PROGRESS_LABELS, MF_RATING_LABELS, MF_SEARCH_INPUT_LABELS, MF_SELECT_LABELS, MF_SIDEBAR_LABELS, MF_STEPPER_LABELS, MF_TABLE_LABELS, MF_TABS_LABELS, MF_THEME_SWITCHER_LABELS, MF_TIME_PICKER_LABELS, MF_TOAST_LABELS, MF_TOUR_LABELS, MF_TREE_SELECT_LABELS, ValueAccessorBase, cn, containerSurface, controlSize, controlSurface, disabledRecipe, errorRecipe, focusRecipe, glassSurface, inlineStartRatio, isRtl, mergeLabels, mfLabelsEn, nextId, overlayPositions, overlaySurface, pressRecipe, provideMesgflowUi, scrollFromInlineStart, transitionRecipe };
+export type { DeepPartial, MfAlertLabels, MfAvatarGroupLabels, MfBoxInputLabels, MfBreadcrumbLabels, MfCharacterCountLabels, MfChartLabels, MfChipLabels, MfColorPickerLabels, MfComboboxLabels, MfCommandLabels, MfCommonLabels, MfCopyLabels, MfDatePickerLabels, MfDialogLabels, MfDropzoneLabels, MfLabels, MfOtpInputLabels, MfPaginationLabels, MfPasswordInputLabels, MfPlacement, MfProgressLabels, MfRatingLabels, MfSearchInputLabels, MfSelectLabels, MfSidebarLabels, MfSize, MfStepperLabels, MfTableFilterLabels, MfTableFilterOperatorLabels, MfTableLabels, MfTablePaginationLabels, MfTabsLabels, MfThemeSwitcherLabels, MfTimePickerLabels, MfToastLabels, MfTone, MfTourLabels, MfTreeSelectLabels, ProvideMesgflowUiOptions };