@mesgflow/ui-kit 0.8.0 → 0.10.0

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

@@ -2,13 +2,17 @@ import * as _angular_core from '@angular/core';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 
-/** `<span mfBadge tone="success">Aktif</span>` */
+/**
+ * `<span mfBadge tone="success">Aktif</span>` — cümle biçimi için
+ * `<span mfBadge tone="warning" casing="sentence">Hazırlanıyor</span>`.
+ */
 declare class Badge {
     readonly tone: _angular_core.InputSignal<"neutral" | "primary" | "success" | "warning" | "danger" | "info" | "help" | null | undefined>;
     readonly size: _angular_core.InputSignal<"sm" | "md" | null | undefined>;
+    readonly casing: _angular_core.InputSignal<"eyebrow" | "sentence" | null | undefined>;
     protected readonly classes: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Badge, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Badge, "span[mfBadge]", never, { "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Badge, "span[mfBadge]", never, { "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "casing": { "alias": "casing"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -30,10 +34,12 @@ declare class Badge {
  */
 declare const badgeVariants: (props?: ({
     tone?: "neutral" | "primary" | "success" | "warning" | "danger" | "info" | "help" | null | undefined;
+    casing?: "eyebrow" | "sentence" | null | undefined;
     size?: "sm" | "md" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type BadgeTone = VariantProps<typeof badgeVariants>['tone'];
 type BadgeSize = VariantProps<typeof badgeVariants>['size'];
+type BadgeCasing = VariantProps<typeof badgeVariants>['casing'];
 
 export { Badge, badgeVariants };
-export type { BadgeSize, BadgeTone };
+export type { BadgeCasing, BadgeSize, BadgeTone };

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

@@ -12,6 +12,10 @@ import * as _angular_core from '@angular/core';
  * - `aria-required="true"` → `required` iken.
  * Hata metni `role="alert"` DEĞİL, `aria-live="polite"` — her tuş vuruşunda
  * ekran okuyucuyu kesmesin. `error` `string | undefined` kabul eder.
+ *
+ * Etiket satırında eylem: `[mfFieldLabelAction]` işaretli çocuk (ör. "Şifremi
+ * unuttum" bağlantısı) etiketin sağına, label'ın KARDEŞİ olarak projekte edilir —
+ * bkz. `FieldLabelAction`. Etiket boşsa da satır eylem için çizilir.
  */
 declare class Field {
     readonly label: _angular_core.InputSignal<string>;
@@ -21,6 +25,8 @@ declare class Field {
     readonly required: _angular_core.InputSignal<boolean>;
     /** `true` ise kalan yüksekliği doldurur (`flex-1 min-h-0`). */
     readonly grow: _angular_core.InputSignal<boolean>;
+    private readonly labelAction;
+    protected readonly hasLabelRow: _angular_core.Signal<boolean>;
     private readonly host;
     private readonly baseId;
     protected readonly hintId: string;
@@ -29,7 +35,23 @@ declare class Field {
     protected readonly describedId: _angular_core.Signal<string | null>;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Field, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<Field, "mf-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "for": { "alias": "for"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "grow": { "alias": "grow"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<Field, "mf-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "for": { "alias": "for"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "grow": { "alias": "grow"; "required": false; "isSignal": true; }; }, {}, ["labelAction"], ["[mfFieldLabelAction]", "*"], true, never>;
+}
+
+/**
+ * `<a mfLink mfFieldLabelAction routerLink="/forgot-password">Şifremi unuttum</a>` —
+ * `mf-field` içine konan öğeyi etiket satırının SAĞINA taşır (yaygın "etiket + eylem"
+ * kalıbı: parola alanının yanında "Şifremi unuttum").
+ *
+ * Öğe `<label>`'ın İÇİNE değil, KARDEŞİNE projekte edilir — label içindeki bir bağlantı
+ * tıklamayı alana yönlendirir ve ekran okuyucuda etiket adına karışırdı. DOM sırası =
+ * görsel sıra (etiket → eylem → alan), sekme sırası da buna uyar.
+ *
+ * `ms-auto`: etiket yoksa ya da dar ekranda alt satıra sarıldığında da sağda kalır.
+ */
+declare class FieldLabelAction {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FieldLabelAction, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldLabelAction, "[mfFieldLabelAction]", never, {}, {}, never, never, true, never>;
 }
 
-export { Field };
+export { Field, FieldLabelAction };

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

@@ -71,6 +71,7 @@ declare class Input {
     readonly maxRows: _angular_core.InputSignal<number | null>;
     private readonly elementRef;
     private readonly nativeSizing;
+    private readonly inGroup;
     private lastValue;
     private lastWidth;
     protected readonly classes: _angular_core.Signal<string>;
@@ -84,7 +85,7 @@ declare class Input {
 /**
  * `<mf-input-group>
  *    <span mfInputPrefix><span mfIcon>search</span></span>
- *    <input mfInput class="border-0 bg-transparent shadow-none focus-visible:outline-none" />
+ *    <input mfInput />
  *    <span mfInputSuffix><button type="button">×</button></span>
  *  </mf-input-group>`
  *
@@ -92,15 +93,14 @@ declare class Input {
  * yazdığı "kabuk" reçetesini (bkz. plan Faz 2 P0) `core/recipes.ts`'in
  * `controlSurface`/`controlSize`'ına indirger — üç ayrı kopya yerine TEK
  * kaynak. İçindeki `input[mfInput]` KENDİ border/shadow/outline'ını
- * KAPATMALI (yukarıdaki örnekteki class'lar) — kabuk artık bunları BURADAN
- * sağlıyor, "çift kenarlık" olmasın diye (bkz. `DateRangePicker`'ın eski
- * `wrapperClasses` notu, aynı gerekçe).
+ * kapatır — grubu DI ile algılayıp (bkz. `input.ts` `IN_GROUP_CLASSES`); kabuk
+ * bunları BURADAN sağlıyor, "çift kenarlık" olmasın diye. Tüketici sınıf yazmaz.
  *
  * Odak halkası `has-[:focus-visible]:outline` ile İÇ elemanlardan HERHANGİ
  * biri klavye-odaklandığında TÜM kabuğun etrafında TEK bir halka çizer
  * (`DateRangePicker`'ın iki input'u arasında geçişte "zıplayan" iki ayrı
- * halka yerine) — `input[mfInput]`'un KENDİ `focus-visible:outline`'ı
- * BİLEREK kapatılmalı (yukarıdaki örnek), aksi halde İKİ halka üst üste biner.
+ * halka yerine) — `input[mfInput]`'un KENDİ `focus-visible:outline`'ı bu
+ * yüzden grup içinde otomatik kapanır, aksi halde İKİ halka üst üste binerdi.
  */
 declare class InputGroup {
     readonly size: _angular_core.InputSignal<MfSize>;
@@ -164,6 +164,8 @@ declare class InputSuffix {
  * textarea `rows` arttıkça bu tabanın üstüne doğal büyüyor. `min-h-(--control-h-*)`
  * — Tailwind v4'ün parantezli kısayolu, `--control-h-*` token'ına (radius.css)
  * doğrudan referans, ayrı bir `min-h-control-*` utility'si tanımlamaya gerek yok.
+ * `py-*` + satır yüksekliği + kenarlık token'ı AŞMAMALI — aşarsa `min-h` etkisiz kalır ve
+ * alan `mf-input-group`/`mfButton`'dan uzun çıkar (lg eskiden `py-2` + `text-base` = 42px ≠ 40px).
  *
  * `hasError` (invalid DEĞİL): `@angular/forms/signals`'ın `[formField]`
  * directive'i, AYNI native elemandaki başka bir directive'in `invalid`/

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

@@ -1,9 +1,10 @@
 import * as i0 from '@angular/core';
 import * as i1 from '@angular/aria/menu';
-import { Menu as Menu$1 } from '@angular/aria/menu';
+import { MenuItem as MenuItem$1, Menu as Menu$1 } from '@angular/aria/menu';
+import { MfPlacement } from '@mesgflow/ui-kit/core';
+import * as i2 from '@angular/cdk/overlay';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
-import * as _angular_cdk_overlay from '@angular/cdk/overlay';
 
 /**
  * `<mf-menu #menu="ngMenu" (itemSelected)="onSelect($event)"><button mfMenuItem value="a">A</button></mf-menu>`
@@ -24,12 +25,19 @@ declare class Menu {
     static ɵcmp: i0.ɵɵComponentDeclaration<Menu, "mf-menu", ["mfMenu"], {}, {}, never, ["*"], true, [{ directive: typeof i1.Menu; inputs: { "wrap": "wrap"; "disabled": "disabled"; "typeaheadDelay": "typeaheadDelay"; }; outputs: { "itemSelected": "itemSelected"; }; }]>;
 }
 
-/** `<button mfMenuItem value="delete">Sil</button>` — `mf-menu` içine konur. */
+/**
+ * `<button mfMenuItem value="delete">Sil</button>` — `mf-menu` içine konur.
+ *
+ * `checked` verilirse (true/false) öğe tek-seçimli bir grubun parçası olur:
+ * `role="menuitemradio"` + `aria-checked`, seçili öğenin sağında tik. Verilmezse
+ * (`undefined`) düz `menuitem` — eski davranış birebir.
+ */
 declare class MenuItem<V> {
-    private readonly ariaMenuItem;
+    readonly checked: i0.InputSignal<boolean | undefined>;
+    protected readonly ariaMenuItem: MenuItem$1<V>;
     protected readonly classes: i0.Signal<string>;
     static ɵfac: i0.ɵɵFactoryDeclaration<MenuItem<any>, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MenuItem<any>, "button[mfMenuItem], div[mfMenuItem]", never, {}, {}, never, never, true, [{ directive: typeof i1.MenuItem; inputs: { "value": "value"; "disabled": "disabled"; "id": "id"; }; outputs: {}; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MenuItem<any>, "button[mfMenuItem], div[mfMenuItem]", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, [{ directive: typeof i1.MenuItem; inputs: { "value": "value"; "disabled": "disabled"; "id": "id"; }; outputs: {}; }]>;
 }
 
 /**
@@ -39,10 +47,58 @@ declare class MenuItem<V> {
  * headless, konum bilgisi taşımıyor; `mf-popover`'ın `[open]="trigger.expanded()"`
  * ile beslenmesi gerekiyor (bkz. playground'daki Menu demosu, `(closed)`
  * çıktısında `trigger.close()` çağırarak iki state'i senkron tutma deseni).
+ *
+ * Konumlandırmayı kendisi yapan (ve `@angular/cdk` import'u gerektirmeyen) biçim
+ * için bkz. `MenuTriggerFor` — `[mfMenuTrigger]="menuRef"`. İkisinin seçicisi
+ * `[menu]` bağlamasının varlığıyla ayrışır, aynı elemanda asla ikisi birden eşleşmez.
  */
 declare class MenuTrigger {
     static ɵfac: i0.ɵɵFactoryDeclaration<MenuTrigger, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MenuTrigger, "[mfMenuTrigger]", ["mfMenuTrigger"], {}, {}, never, never, true, [{ directive: typeof i1.MenuTrigger; inputs: { "menu": "menu"; "disabled": "disabled"; }; outputs: {}; }]>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MenuTrigger, "[mfMenuTrigger][menu]", ["mfMenuTrigger"], {}, {}, never, never, true, [{ directive: typeof i1.MenuTrigger; inputs: { "menu": "menu"; "disabled": "disabled"; }; outputs: {}; }]>;
+}
+/**
+ * `<button mfButton [mfMenuTrigger]="langMenu">TR</button>
+ *  <mf-menu #langMenu="ngMenu" (itemSelected)="setLang($event)">…</mf-menu>`
+ *
+ * Tek düğmeli açılır menü — tüketici `@angular/cdk` import etmez, `mf-popover`
+ * sarmalamaz. Menü şablonda NORMAL yerinde durur (kapalıyken gizli), açılınca
+ * `DomPortal` ile overlay'e TAŞINIR ve tetiğe göre `placement`'a konumlanır;
+ * kapanınca çıkış animasyonundan sonra eski yerine döner — Angular'ın mantıksal
+ * ağacı (içerik projeksiyonu, `mfMenuItem` ↔ `mf-menu` DI bağı) hiç değişmez.
+ *
+ * `[mfMenuTrigger]`'a `mf-menu`'nün `ngMenu` referansı verilir (`mfMenu` DEĞİL —
+ * `@angular/aria`'nın tetikleyicisi kendi `Menu` örneğini ister). ARIA/klavye
+ * (`aria-haspopup`/`aria-expanded`, ok tuşları, typeahead, Enter/Boşluk seçer, Esc
+ * kapatıp odağı tetiğe döndürür) `@angular/aria/menu`'den; bu directive üstüne:
+ * seçimde kapanıp odağı tetiğe döndürme, dışarı tıklamada kapanma.
+ *
+ * Tetik aynı zamanda bir `CdkOverlayOrigin` (host directive) — ayrıca
+ * `cdkOverlayOrigin` yazılmaz.
+ */
+declare class MenuTriggerFor {
+    /** Menünün tetiğe göre konumu — `left`/`right` mantıksal (RTL'de çevrilir). */
+    readonly placement: i0.InputSignal<MfPlacement>;
+    private readonly aria;
+    private readonly overlay;
+    private readonly host;
+    private overlayRef?;
+    private exitTimer?;
+    /** Kapalıyken gizlenen (ve açıkken overlay'e taşınan) menü elemanı. */
+    private hiddenMenu?;
+    private selection?;
+    constructor();
+    /** Public — menüyü kapatır, odak yerinde kalır (aria `close()` ile aynı). */
+    close(): void;
+    /** Public — menüyü açar ve ilk öğeye odaklanır. */
+    open(): void;
+    private bindMenu;
+    private unbindMenu;
+    private attach;
+    private detach;
+    private ensureOverlay;
+    private positionStrategy;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MenuTriggerFor, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MenuTriggerFor, "[mfMenuTrigger]:not([menu])", ["mfMenuTrigger"], { "placement": { "alias": "placement"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.MenuTrigger; inputs: { "menu": "mfMenuTrigger"; "disabled": "disabled"; }; outputs: {}; }, { directive: typeof i2.CdkOverlayOrigin; inputs: {}; outputs: {}; }]>;
 }
 
 declare const menuItemVariants: (props?: ({
@@ -83,10 +139,10 @@ declare class Menubar<V = string> {
     readonly itemSelect: i0.OutputEmitterRef<V>;
     protected readonly rendered: i0.WritableSignal<boolean>;
     protected readonly submenus: i0.Signal<readonly Menu$1<V>[]>;
-    protected readonly positions: _angular_cdk_overlay.ConnectedPosition[];
+    protected readonly positions: i2.ConnectedPosition[];
     static ɵfac: i0.ɵɵFactoryDeclaration<Menubar<any>, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<Menubar<any>, "mf-menubar", ["mfMenubar"], { "menus": { "alias": "menus"; "required": true; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "itemSelect": "itemSelect"; }, never, never, true, never>;
 }
 
-export { Menu, MenuItem, MenuTrigger, Menubar, menuItemVariants };
+export { Menu, MenuItem, MenuTrigger, MenuTriggerFor, Menubar, menuItemVariants };
 export type { MenuItemActive, MenubarAction, MenubarMenu };

package/types/mesgflow-ui-kit-password-input.d.ts

@@ -1,6 +1,6 @@
 import * as _angular_core from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
-import { ValueAccessorBase } from '@mesgflow/ui-kit/core';
+import { ValueAccessorBase, MfSize } from '@mesgflow/ui-kit/core';
 
 /**
  * Parola alanının `autocomplete` ipucu — parola yöneticileri/tarayıcı bunu okur:
@@ -26,9 +26,17 @@ type PasswordAutocomplete = 'current-password' | 'new-password' | 'off' | (strin
  * harfe çevirmez, yazım denetimi parolayı bir sözlük servisine göndermez.
  * Signal Forms `[formField]` bağlandığında `name`/`required`/`readonly`/`disabled`
  * alan durumundan OTOMATİK doldurulur.
+ *
+ * `size`: `input[mfInput]`/`mf-input-group` ile AYNI yükseklik/dolgu/font token'ları —
+ * aynı boydaki düz bir `mfInput` ile yan yana hizalı durur; göster/gizle ikonu boyla büyür.
+ *
+ * Önek: `[mfInputPrefix]` işaretli çocuk (ör. `<span mfIcon mfInputPrefix>lock</span>`)
+ * alanın soluna, `mf-input-group`'un önek yuvasına projekte edilir — metin başlangıcı
+ * önekli bir `mf-input-group` ile aynı. Önek dekoratif kabul edilir (`aria-hidden`).
  */
 declare class PasswordInput extends ValueAccessorBase<string> implements ControlValueAccessor {
     readonly value: _angular_core.ModelSignal<string>;
+    readonly size: _angular_core.InputSignal<MfSize>;
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly hasError: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -51,12 +59,13 @@ declare class PasswordInput extends ValueAccessorBase<string> implements Control
     private readonly formDisabled;
     protected readonly isDisabled: _angular_core.Signal<boolean>;
     protected readonly visible: _angular_core.WritableSignal<boolean>;
+    protected readonly toggleIconSize: _angular_core.Signal<number>;
     writeValue(value: string | null): void;
     setDisabledState(disabled: boolean): void;
     protected toggle(): void;
     protected onInput(raw: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PasswordInput, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PasswordInput, "mf-password-input", ["mfPasswordInput"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "hasError": { "alias": "hasError"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "hideLabel": { "alias": "hideLabel"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PasswordInput, "mf-password-input", ["mfPasswordInput"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "hasError": { "alias": "hasError"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "hideLabel": { "alias": "hideLabel"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, ["[mfInputPrefix]"], true, never>;
 }
 
 export { PasswordInput };

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

@@ -1,10 +1,26 @@
-import * as _angular_cdk_overlay from '@angular/cdk/overlay';
+import * as i1 from '@angular/cdk/overlay';
 import { CdkOverlayOrigin } from '@angular/cdk/overlay';
 import * as _angular_core from '@angular/core';
+import { ElementRef } from '@angular/core';
 import { MfPlacement } from '@mesgflow/ui-kit/core';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 
+/**
+ * `<button #trigger="mfPopoverOrigin" mfPopoverOrigin (click)="open.set(true)">…</button>
+ *  <mf-popover [origin]="trigger" [(open)]="open">…</mf-popover>`
+ *
+ * `mf-popover`'ın `[origin]`'i için kitin kendi çapası — tüketici `@angular/cdk`
+ * import etmeden `cdkOverlayOrigin` ile aynı işi görür (host directive olarak onu
+ * taşır). `[origin]` ayrıca bir `HTMLElement`/`ElementRef` (`#ref` şablon
+ * referansı) de kabul eder.
+ */
+declare class PopoverOrigin {
+    readonly elementRef: ElementRef<HTMLElement>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverOrigin, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<PopoverOrigin, "[mfPopoverOrigin]", ["mfPopoverOrigin"], {}, {}, never, never, true, [{ directive: typeof i1.CdkOverlayOrigin; inputs: {}; outputs: {}; }]>;
+}
+
 /**
  * Tüm `MfPlacement` değerleri — `left`/`right` MANTIKSAL (RTL'de çevrilir).
  * `right-start`: tetikleyicinin ÜSTÜYLE hizalı (Sidebar daraltılmış nav
@@ -12,6 +28,12 @@ import { VariantProps } from 'class-variance-authority';
  * beklenmedik yönde kaydırır), 8px boşlukla.
  */
 type PopoverPlacement = MfPlacement;
+/**
+ * `[origin]`'in kabul ettiği çapalar: kitin `mfPopoverOrigin`'i (tercih edilen —
+ * tüketici `@angular/cdk` import etmez), CDK'nın `cdkOverlayOrigin`'i (geriye
+ * uyumlu) ya da düz bir eleman (`#ref` şablon referansı / `ElementRef`).
+ */
+type PopoverOriginRef = PopoverOrigin | CdkOverlayOrigin | ElementRef<HTMLElement> | HTMLElement;
 /**
  * `<button cdkOverlayOrigin #trigger="cdkOverlayOrigin" (click)="open.set(true)">...</button>`
  * `<mf-popover [origin]="trigger" [(open)]="open">...içerik (ng-content)...</mf-popover>`
@@ -25,11 +47,12 @@ type PopoverPlacement = MfPlacement;
  * Popover'ın panel içeriğiyle nasıl kompoze edeceğine karar vermeli, ayrı ve
  * her ekranın tarayıcıda tek tek doğrulanmasını gerektiren bir iş.
  *
- * `origin`, CDK'nın `cdkOverlayOrigin` directive'inin `exportAs` referansı —
- * ayrı bir wrapper directive'e gerek yok, CDK zaten sağlıyor.
+ * `origin`: kitin `mfPopoverOrigin` referansı (tüketici `@angular/cdk` import
+ * etmez), geriye uyumlu olarak `cdkOverlayOrigin` ya da düz bir eleman — bkz.
+ * `PopoverOriginRef`.
  */
 declare class Popover {
-    readonly origin: _angular_core.InputSignal<CdkOverlayOrigin>;
+    readonly origin: _angular_core.InputSignal<PopoverOriginRef>;
     readonly open: _angular_core.ModelSignal<boolean>;
     readonly placement: _angular_core.InputSignal<MfPlacement>;
     readonly padding: _angular_core.InputSignal<"none" | "sm" | "md" | "lg" | null | undefined>;
@@ -53,7 +76,9 @@ declare class Popover {
     protected readonly attached: _angular_core.WritableSignal<boolean>;
     protected readonly closing: _angular_core.WritableSignal<boolean>;
     private exitTimer?;
-    protected readonly positions: _angular_core.Signal<_angular_cdk_overlay.ConnectedPosition[]>;
+    /** CDK'ya verilen çapa — `cdkConnectedOverlayOrigin` bir `ElementRef`'i doğrudan kabul eder. */
+    protected readonly anchor: _angular_core.Signal<ElementRef<HTMLElement>>;
+    protected readonly positions: _angular_core.Signal<i1.ConnectedPosition[]>;
     protected readonly classes: _angular_core.Signal<string>;
     constructor();
     protected close(): void;
@@ -66,5 +91,5 @@ declare const popoverPanelVariants: (props?: ({
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type PopoverPadding = VariantProps<typeof popoverPanelVariants>['padding'];
 
-export { Popover, popoverPanelVariants };
-export type { PopoverPadding, PopoverPlacement };
+export { Popover, PopoverOrigin, popoverPanelVariants };
+export type { PopoverOriginRef, PopoverPadding, PopoverPlacement };

package/types/mesgflow-ui-kit-segmented-control.d.ts

@@ -14,8 +14,16 @@ interface SegmentedOption<T> {
  * farkı: içerik paneli YOK, sadece bir değer seçimi. ARIA/klavye (roving
  * tabindex, ok tuşu navigasyonu) `@angular/aria/toolbar`'ın
  * `Toolbar`/`ToolbarWidgetGroup`/`ToolbarWidget` pattern'inden geliyor —
- * dokümantasyondaki kompozisyon şekli birebir izlendi (dıştaki `ngToolbar`,
- * içteki `ngToolbarWidgetGroup [multi]="false"`).
+ * dokümantasyondaki kompozisyon şekli izlendi (dıştaki `ngToolbar`, içteki
+ * `ngToolbarWidgetGroup`).
+ *
+ * SEÇİM toolbar'dan DEĞİL, bileşenin kendisinden: `@angular/aria` 22.2 toolbar'ın
+ * `value`/`valueChange`'ini ve grubun `multi`'sini KALDIRDI (toolbar artık yalnızca
+ * gezinme). Kit önceden derlendiği için tüketicide derleme hatası çıkmıyor, tıklama
+ * sessizce etkisiz kalıyordu (gerçek bulgu, 0.6–0.8). Artık tıklama + Enter/Space
+ * doğrudan `select()`'i çağırır — 22.1 ve 22.2'de aynı çalışır. Widget'ın `[value]`'su
+ * yalnızca 22.1'in zorunlu girdisi için duruyor (22.2'de düğmenin DOM `value`'suna düşer).
+ * Seçili durum `aria-pressed` ile duyurulur (toolbar hiçbir sürümde vermiyor).
  *
  * Seçili parça core'un `[mfSlidingIndicator]`'ıyla (Tabs ile aynı motor) yay
  * eğrisiyle kayar; aria/toolbar seçili öznitelik vermediği için hedef
@@ -27,19 +35,19 @@ declare class SegmentedControl<T> extends ValueAccessorBase<T | null> implements
     readonly size: _angular_core.InputSignal<"sm" | "md" | null | undefined>;
     readonly ariaLabel: _angular_core.InputSignal<string>;
     readonly disabled: _angular_core.InputSignal<boolean>;
-    protected readonly toolbarValue: _angular_core.Signal<T[]>;
     protected readonly trackClasses: _angular_core.Signal<string>;
     writeValue(value: T | null): void;
     /**
-     * `@angular/aria/toolbar`'ın kendi widget-kayıt döngüsü, gerçek bir tıklama
-     * OLMADAN da BOŞ bir dizi ile (`values: []`) tetiklenebiliyor (gerçek bulgu
-     * — bir seçeneğe tıklarken bile araya giren, seçimle ilgisiz iç kayıt
-     * event'leri). `this.value` her event'te güncellenir (görsel durum ETKİLENMEZ,
-     * zaten `values[0]` genelde mevcut değerle AYNI), ama CVA `onChange`/`onTouched`
-     * SADECE dolu bir dizi (gerçek bir seçim) geldiğinde tetiklenir — aksi halde
-     * Reactive Forms'a sahte "null'a değişti" bildirimleri sızardı.
+     * Seçili seçeneğe tekrar basmak seçimi KALDIRMAZ (segmented control'de her zaman bir
+     * seçim durur) ve değişiklik bildirmez; CVA `onChange` yalnızca gerçek bir değişimde.
+     */
+    protected select(value: T): void;
+    /**
+     * Enter/Space: 22.1'in toolbar'ı bu tuşları kendisi yakalayıp `preventDefault` ettiği
+     * için düğmenin yerel `click`'i gelmiyordu; 22.2'de geliyor. Burada seçip varsayılanı
+     * engellemek iki sürümde de TEK seçim üretir.
      */
-    protected onToolbarValueChange(values: readonly T[]): void;
+    protected onActivateKey(event: Event, value: T): void;
     protected itemClasses(option: SegmentedOption<T>): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SegmentedControl<any>, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SegmentedControl<any>, "mf-segmented-control", ["mfSegmentedControl"], { "options": { "alias": "options"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;