@handijit/ui 0.0.0-stage → 1.0.0

package/build/components/Link/index.js

@@ -0,0 +1,11 @@
+"use client";
+import { jsx as i } from "react/jsx-runtime";
+import { useUi as e } from "../../theme/context.js";
+const p = ({ children: n, ...o }) => {
+  const { linkComponent: t } = e();
+  return t ? /* @__PURE__ */ i(t, { ...o, children: n }) : /* @__PURE__ */ i("a", { ...o, children: n });
+};
+export {
+  p as default
+};
+//# sourceMappingURL=index.js.map

package/build/components/Link/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/components/Link/index.tsx"],"sourcesContent":["'use client';\n\nimport type { AnchorHTMLAttributes, FC } from 'react';\n\nimport { useUi } from '../../theme/context';\nimport type { UiLinkProps } from '../../types/link.type';\n\n/** Kütüphanenin İÇ bağlantı öğesi. */\nconst UiLink: FC<UiLinkProps> = ({ children, ...rest }) => {\n  const { linkComponent: LinkComponent } = useUi();\n\n  if (LinkComponent) return <LinkComponent {...(rest as UiLinkProps)}>{children}</LinkComponent>;\n\n  /*\n   * Yonlendirici yoksa ham `<a>`. `rest` indeks imzasi tasiyor (yonlendiriciye ozgu props icin);\n   * DOM'a giderken anchor sozlesmesine daraltilir\n   */\n  return <a {...(rest as AnchorHTMLAttributes<HTMLAnchorElement>)}>{children}</a>;\n};\n\nexport default UiLink;\n"],"names":["UiLink","children","rest","LinkComponent","useUi","jsx"],"mappings":";;;AAOA,MAAMA,IAA0B,CAAC,EAAE,UAAAC,GAAU,GAAGC,QAAW;AACzD,QAAM,EAAE,eAAeC,EAAA,IAAkBC,EAAA;AAEzC,SAAID,IAAsB,gBAAAE,EAACF,GAAA,EAAe,GAAID,GAAuB,UAAAD,GAAS,IAMvE,gBAAAI,EAAC,KAAA,EAAG,GAAIH,GAAmD,UAAAD,EAAA,CAAS;AAC7E;"}

package/build/components/Menu/index.cjs

@@ -0,0 +1,2 @@
+"use client";"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const o=require("react/jsx-runtime"),t=require("react"),$=require("react-dom"),R=require("../../helpers/class-name.helper.cjs"),F=require("../../helpers/component.helper.cjs"),T=require("../../helpers/focus.helper.cjs"),B=require("../../hooks/usePortalSurface.cjs"),U=require("../../hooks/usePositioning.cjs"),D={default:{"menu":"ui-menu-1x-FU","menu--top":"ui-menu--top-gpo39","menu--bottom":"ui-menu--bottom-6sL7b","menu--left":"ui-menu--left-4w-O8","menu--right":"ui-menu--right-XmM8G","menu__header":"ui-menu__header--yAhp","menu__list":"ui-menu__list-9nZDG","menu__item":"ui-menu__item-d1iil","menu__item--danger":"ui-menu__item--danger-lIINY","menu__icon":"ui-menu__icon-kzLV2"}},C=s=>s.map((c,f)=>c.isDisabled?-1:f).filter(c=>c>=0),A=({id:s,items:c,label:f,anchorRef:k,ownerRef:p,side:j,align:v,offset:w,initial:x,header:r,className:m,testId:b,onClose:u,onContextMenu:E})=>{const h=t.useRef(null),_=t.useRef({text:"",at:0}),a=C(c),[l,g]=t.useState(()=>x==="first"?a[0]:a[a.length-1]),n=U.default(k,h,{side:j,align:v,offset:w,isOpen:!0}),d=B.default(!0,p,h),{isPositioned:S}=n;t.useEffect(()=>{var e,i;S&&((i=(e=h.current)==null?void 0:e.querySelector(`[data-index="${l}"]`))==null||i.focus({preventScroll:!0}))},[l,S]),t.useEffect(()=>{const e=i=>{var M,q;const y=i.target;(M=h.current)!=null&&M.contains(y)||(q=p.current)!=null&&q.contains(y)||u()};return document.addEventListener("mousedown",e),()=>document.removeEventListener("mousedown",e)},[p,u]);const I=e=>{const y=(a.indexOf(l)+e+a.length)%a.length;g(a[y])},P=e=>{const i=Date.now(),y=i-_.current.at>500?e:_.current.text+e;_.current={text:y,at:i};const M=a.find(q=>c[q].label.toLocaleLowerCase("tr").startsWith(y.toLocaleLowerCase("tr")));M!==void 0&&g(M)},K=e=>{switch(e.key){case"ArrowDown":e.preventDefault(),I(1);break;case"ArrowUp":e.preventDefault(),I(-1);break;case"Home":e.preventDefault(),g(a[0]);break;case"End":e.preventDefault(),g(a[a.length-1]);break;case"Escape":e.preventDefault(),u();break;case"Tab":u();break;default:e.key.length===1&&!e.metaKey&&!e.ctrlKey&&P(e.key)}};if(!d.container)return null;const L=c.map((e,i)=>o.jsxs("button",{type:"button",role:"menuitem","data-index":i,tabIndex:i===l?0:-1,disabled:e.isDisabled,className:R.cx(D.default.menu__item,e.isDanger&&D.default["menu__item--danger"]),onClick:()=>{e.onSelect(),u()},children:[e.icon&&o.jsx("span",{className:D.default.menu__icon,"aria-hidden":!0,children:e.icon}),e.label]},e.id)),N={ref:h,...d.attributes,className:R.cx(D.default.menu,D.default[`menu--${n.side}`],m),style:{...n.style,...d.style,visibility:n.isPositioned?"visible":"hidden"},"data-testid":b,onContextMenu:E},O=`${s}-header`;return $.createPortal(r?o.jsxs("div",{...N,children:[o.jsx("div",{id:O,className:D.default.menu__header,children:r}),o.jsx("div",{id:s,role:"menu","aria-label":f,"aria-describedby":O,className:D.default.menu__list,onKeyDown:K,children:L})]}):o.jsx("div",{...N,id:s,role:"menu","aria-label":f,onKeyDown:K,children:L}),d.container)},H=({trigger:s,items:c,label:f,side:k="bottom",align:p="start",className:j,testId:v})=>{const w=t.useId(),x=t.useRef(null),r=t.useRef(null),[m,b]=t.useState(null),u=m!==null,E=C(c),h=t.useCallback(n=>{E.length!==0&&(r.current=T.captureFocus(),b(n))},[E]),_=t.useCallback(()=>{var n;b(null),(n=r.current)==null||n.call(r),r.current=null},[]);t.useEffect(()=>()=>{var n;(n=r.current)==null||n.call(r),r.current=null},[]);const a=n=>{if(n.key==="ArrowUp"){n.preventDefault(),h("last");return}["ArrowDown","Enter"," "].includes(n.key)&&(n.preventDefault(),h("first"))};if(!t.isValidElement(s))return null;const l=s.props,g=t.cloneElement(s,{ref:x,"aria-haspopup":"menu","aria-expanded":u,"aria-controls":u?w:void 0,onClick:n=>{var d;(d=l.onClick)==null||d.call(l,n),u?_():h("first")},onKeyDown:n=>{var d;(d=l.onKeyDown)==null||d.call(l,n),u||a(n)}});return o.jsxs(o.Fragment,{children:[g,m&&o.jsx(A,{id:w,items:c,label:f,anchorRef:x,ownerRef:x,side:k,align:p,initial:m,className:j,testId:v,onClose:_})]})},V=t.memo(F.named(H,"Menu")),W=2,z=s=>s.preventDefault(),G=({point:s,onClose:c,items:f,label:k,header:p,className:j,testId:v})=>{const w=t.useId(),x=t.useRef(null),r=s!==null&&C(f).length>0,m=(s==null?void 0:s.x)??0,b=(s==null?void 0:s.y)??0,u=t.useMemo(()=>({current:{getBoundingClientRect:()=>({top:b,left:m,width:0,height:0})}}),[m,b]);return t.useLayoutEffect(()=>{if(r)return T.captureFocus()},[r]),o.jsxs(o.Fragment,{children:[o.jsx("span",{ref:x,hidden:!0}),r&&o.jsx(A,{id:w,items:f,label:k,anchorRef:u,ownerRef:x,side:"bottom",align:"start",offset:W,initial:"first",header:p,className:j,testId:v,onClose:c,onContextMenu:z},`${m}:${b}`)]})},J=F.named(t.memo(G),"ContextMenu");exports.ContextMenu=J;exports.default=V;
+//# sourceMappingURL=index.cjs.map

package/build/components/Menu/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../src/components/Menu/index.tsx"],"sourcesContent":["'use client';\n\nimport {\n  cloneElement,\n  isValidElement,\n  type KeyboardEvent,\n  memo,\n  type MouseEvent,\n  type ReactElement,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useId,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { createPortal } from 'react-dom';\n\nimport { cx } from '../../helpers/class-name.helper';\nimport { named } from '../../helpers/component.helper';\nimport { captureFocus } from '../../helpers/focus.helper';\nimport usePortalSurface from '../../hooks/usePortalSurface';\nimport usePositioning from '../../hooks/usePositioning';\n\nimport styles from './index.module.scss';\nimport type { PositionAlign, PositionSide, PositioningRect } from '@/types/positioning.type';\n\nexport type MenuItem = {\n  id: string;\n  label: string;\n  icon?: ReactNode;\n  onSelect: () => void;\n  isDisabled?: boolean;\n  /** Geri alınamaz eylem: yıkıcı tonda çizilir. */\n  isDanger?: boolean;\n};\n\ntype Props = {\n  /** Tetikleyici. */\n  trigger: ReactElement;\n  items: MenuItem[];\n  /** Menünün erişilebilir adı (\"Satır eylemleri\"). */\n  label: string;\n  side?: PositionSide;\n  align?: PositionAlign;\n  className?: string;\n  testId?: string;\n};\n\n/** Pasif olmayan seçeneklerin dizinleri. */\nconst enabledIndexes = (items: MenuItem[]): number[] =>\n  items.map((item, index) => (item.isDisabled ? -1 : index)).filter(index => index >= 0);\n\ntype SurfaceProps = {\n  id: string;\n  items: MenuItem[];\n  label: string;\n  /** Konumun ÖLÇÜLDÜĞÜ çapa: tetikleyici ya da imleç noktası. */\n  anchorRef: { current: { getBoundingClientRect: () => PositioningRect } | null };\n  /** Ağaçtaki sahip: portal hedefi (en yakın `<dialog>`) ve dışarı-tıklama istisnası. */\n  ownerRef: { current: HTMLElement | null };\n  side: PositionSide;\n  align: PositionAlign;\n  offset?: number;\n  /** Açılışta odaklanan uç. */\n  initial: 'first' | 'last';\n  header?: ReactNode;\n  className?: string;\n  testId?: string;\n  onClose: () => void;\n  onContextMenu?: (event: MouseEvent) => void;\n};\n\n/**\n * MENÜ YÜZEYİ — `Menu` ve `ContextMenu`nün ortak gövdesi: konum, portal, odak, klavye ve\n * dışarı-tıklama TEK yerde. Yalnızca AÇIKKEN takılır; kapanış sökülmedir.\n */\nconst MenuSurface = ({\n  id,\n  items,\n  label,\n  anchorRef,\n  ownerRef,\n  side,\n  align,\n  offset,\n  initial,\n  header,\n  className,\n  testId,\n  onClose,\n  onContextMenu,\n}: SurfaceProps) => {\n  const surfaceRef = useRef<HTMLDivElement>(null);\n  /* Harfe atlama tamponu: art arda basilan harfler tek bir arama olur. */\n  const typedRef = useRef({ text: '', at: 0 });\n  const enabled = enabledIndexes(items);\n\n  const [activeIndex, setActiveIndex] = useState(() =>\n    initial === 'first' ? enabled[0] : enabled[enabled.length - 1],\n  );\n\n  const positioning = usePositioning(anchorRef, surfaceRef, { side, align, offset, isOpen: true });\n\n  /*\n   * Portal hedefi HER RENDER'DA degil, yalnizca acikken cozulur. `closest` ucuzdur ama\n   * tetikleyicinin DOM konumu acilistan sonra degismedigi icin tekrar…\n   */\n  const portal = usePortalSurface(true, ownerRef, surfaceRef);\n\n  /*\n   * Etkin oge GERCEKTEN odaklanir (APG menu deseni).\n   * ⚠ KONUM OLCULDUKTEN SONRA: yuzey o ana kadar `visibility: hidden` tasir ve gizli oge odak ALMAZ.\n   * Olcum `useLayoutEffect`te durum yazar, ama ayrik olayda (tik, sag tik) React bu commit'in pasif\n   * etkilerini yeniden cizimden ONCE bosaltiyor — odak gizli yuzeye gidip sessizce dusuyordu ve\n   * odak `<body>`de kaliyordu (olculdu: chromium, 5.5.0 `Menu` dahil). jsdom gorunurlugu bilmedigi\n   * icin birim testleri bunu goremiyordu; nobetci `anchored-panel.spec.ts` \"menü açılışında odak\".\n   */\n  const { isPositioned } = positioning;\n\n  useEffect(() => {\n    if (!isPositioned) return;\n    surfaceRef.current\n      ?.querySelector<HTMLElement>(`[data-index=\"${activeIndex}\"]`)\n      ?.focus({ preventScroll: true });\n  }, [activeIndex, isPositioned]);\n\n  useEffect(() => {\n    const handlePointerDown = (event: globalThis.MouseEvent) => {\n      const target = event.target as Node;\n      if (surfaceRef.current?.contains(target) || ownerRef.current?.contains(target)) return;\n      onClose();\n    };\n\n    document.addEventListener('mousedown', handlePointerDown);\n    return () => document.removeEventListener('mousedown', handlePointerDown);\n  }, [ownerRef, onClose]);\n\n  const step = (offsetBy: number) => {\n    const position = enabled.indexOf(activeIndex);\n    const next = (position + offsetBy + enabled.length) % enabled.length;\n    setActiveIndex(enabled[next]);\n  };\n\n  /** Harfe atlama: 500 ms içinde basılan harfler tek bir arama. */\n  const jumpToLetter = (key: string) => {\n    const now = Date.now();\n    const buffer = now - typedRef.current.at > 500 ? key : typedRef.current.text + key;\n    typedRef.current = { text: buffer, at: now };\n\n    const match = enabled.find(index =>\n      items[index].label.toLocaleLowerCase('tr').startsWith(buffer.toLocaleLowerCase('tr')),\n    );\n\n    if (match !== undefined) setActiveIndex(match);\n  };\n\n  const handleMenuKeyDown = (event: KeyboardEvent) => {\n    switch (event.key) {\n      case 'ArrowDown':\n        event.preventDefault();\n        step(1);\n        break;\n\n      case 'ArrowUp':\n        event.preventDefault();\n        step(-1);\n        break;\n\n      case 'Home':\n        event.preventDefault();\n        setActiveIndex(enabled[0]);\n        break;\n\n      case 'End':\n        event.preventDefault();\n        setActiveIndex(enabled[enabled.length - 1]);\n        break;\n\n      case 'Escape':\n        /*\n         * `preventDefault` SAYFAYA \"bu Escape islendi\" der: `window`da Escape dinleyen kod\n         * (`event.defaultPrevented`) menuyu kapatan tusla kendi eylemini de calistirmaz.\n         */\n        event.preventDefault();\n        onClose();\n        break;\n\n      case 'Tab':\n        /*\n         * Menu KAPANIR ama gezinme SURER: kullanici menuden cikip sayfaya devam ediyor.\n         * `preventDefault` yok.\n         */\n        onClose();\n        break;\n\n      default:\n        if (event.key.length === 1 && !event.metaKey && !event.ctrlKey) jumpToLetter(event.key);\n    }\n  };\n\n  if (!portal.container) return null;\n\n  const buttons = items.map((item, index) => (\n    <button\n      key={item.id}\n      type=\"button\"\n      role=\"menuitem\"\n      data-index={index}\n      /* DONEN `tabindex`: menu Tab sirasinda TEK durak. */\n      tabIndex={index === activeIndex ? 0 : -1}\n      disabled={item.isDisabled}\n      className={cx(styles.menu__item, item.isDanger && styles['menu__item--danger'])}\n      onClick={() => {\n        item.onSelect();\n        onClose();\n      }}\n      /*\n       * ⚠ `onMouseEnter` KALDIRILDI. Eskiden fare bir ogenin uzerine\n       * geldiginde `setActiveIndex` cagriliyordu; asagidaki etki de\n       * `activeIndex` degisince `.focus()` cagirdigi icin sonuc\n       * **farenin klavye odagini calmasi** oluyordu: kullanici ok\n       * tuslariyla gezinirken imlecin durdugu yer ya da menunun\n       * imlecin altinda kaymasi odagi geri firlatiyordu.\n       *\n       * Kaldirilan yorumun gerekcesi \"iki ayri vurgu kullaniciyi\n       * sasirtiyordu\" idi; o sorun VURGULARI AYIRARAK cozuldu:\n       * hover = arka plan, klavye odagi = halka (`index.module.scss`).\n       * Ikisi artik farkli sey soyluyor, cakismiyor.\n       */\n    >\n      {item.icon && (\n        <span className={styles.menu__icon} aria-hidden>\n          {item.icon}\n        </span>\n      )}\n      {item.label}\n    </button>\n  ));\n\n  const surface = {\n    ref: surfaceRef,\n    /* ⚠ Modalin ICINDEN acildiginda yuzey UST KATMANA cikmak ZORUNDA. */\n    ...portal.attributes,\n    className: cx(styles.menu, styles[`menu--${positioning.side}`], className),\n    style: {\n      ...positioning.style,\n      ...portal.style,\n      visibility: positioning.isPositioned ? ('visible' as const) : ('hidden' as const),\n    },\n    'data-testid': testId,\n    onContextMenu,\n  };\n\n  const headerId = `${id}-header`;\n\n  return createPortal(\n    /*\n     * BASLIK `role=\"menu\"`nun DISINDA: menu yalniz `menuitem` tasir. Baslik menuye\n     * `aria-describedby` ile baglanir — ok tuslari ogeler arasinda gezerken baglam okunur.\n     */\n    header ? (\n      <div {...surface}>\n        <div id={headerId} className={styles.menu__header}>\n          {header}\n        </div>\n        <div\n          id={id}\n          role=\"menu\"\n          aria-label={label}\n          aria-describedby={headerId}\n          className={styles.menu__list}\n          onKeyDown={handleMenuKeyDown}\n        >\n          {buttons}\n        </div>\n      </div>\n    ) : (\n      <div {...surface} id={id} role=\"menu\" aria-label={label} onKeyDown={handleMenuKeyDown}>\n        {buttons}\n      </div>\n    ),\n    portal.container,\n  );\n};\n\n/** Menü — bir listeden EYLEM seçme. */\nconst Menu = ({\n  trigger,\n  items,\n  label,\n  side = 'bottom',\n  align = 'start',\n  className,\n  testId,\n}: Props) => {\n  const id = useId();\n  const anchorRef = useRef<HTMLElement>(null);\n  const restoreRef = useRef<(() => void) | null>(null);\n\n  /* Acilisin hangi uca odaklanacagi; `null` = kapali. */\n  const [opening, setOpening] = useState<'first' | 'last' | null>(null);\n  const isOpen = opening !== null;\n  const enabled = enabledIndexes(items);\n\n  const open = useCallback(\n    (target: 'first' | 'last') => {\n      if (enabled.length === 0) return;\n      restoreRef.current = captureFocus();\n      setOpening(target);\n    },\n    [enabled],\n  );\n\n  const close = useCallback(() => {\n    setOpening(null);\n    /*\n     * Odak TETIKLEYICIYE doner: donmezse `<body>`ye duser ve klavye kullanicisi sayfanin en basina\n     * giderdi.\n     */\n    restoreRef.current?.();\n    restoreRef.current = null;\n  }, []);\n\n  /*\n   * Geri yukleme YALNIZCA `close()` icindeydi, yani menu ACIKKEN sokuldugunde hic calismiyordu.\n   * ⚠ SOKULME de bir kapanistir.\n   */\n  useEffect(\n    () => () => {\n      restoreRef.current?.();\n      restoreRef.current = null;\n    },\n    [],\n  );\n\n  const handleTriggerKeyDown = (event: KeyboardEvent) => {\n    if (event.key === 'ArrowUp') {\n      event.preventDefault();\n      open('last');\n      return;\n    }\n\n    if (['ArrowDown', 'Enter', ' '].includes(event.key)) {\n      event.preventDefault();\n      open('first');\n    }\n  };\n\n  if (!isValidElement(trigger)) return null;\n\n  const triggerProps = trigger.props as Record<string, unknown>;\n\n  const anchor = cloneElement(trigger as ReactElement<Record<string, unknown>>, {\n    ref: anchorRef,\n    'aria-haspopup': 'menu',\n    'aria-expanded': isOpen,\n    'aria-controls': isOpen ? id : undefined,\n    onClick: (event: MouseEvent) => {\n      (triggerProps.onClick as ((event: MouseEvent) => void) | undefined)?.(event);\n      if (isOpen) close();\n      else open('first');\n    },\n    onKeyDown: (event: KeyboardEvent) => {\n      (triggerProps.onKeyDown as ((event: KeyboardEvent) => void) | undefined)?.(event);\n      if (!isOpen) handleTriggerKeyDown(event);\n    },\n  });\n\n  return (\n    <>\n      {anchor}\n\n      {opening && (\n        <MenuSurface\n          id={id}\n          items={items}\n          label={label}\n          anchorRef={anchorRef}\n          ownerRef={anchorRef}\n          side={side}\n          align={align}\n          initial={opening}\n          className={className}\n          testId={testId}\n          onClose={close}\n        />\n      )}\n    </>\n  );\n};\n\nexport default /*#__PURE__*/ memo(/*#__PURE__*/ named(Menu, 'Menu')) as typeof Menu;\n\ntype ContextMenuProps = {\n  /**\n   * Açılış noktası — `contextmenu` olayının `clientX` / `clientY`si (görünüm alanı koordinatı).\n   * `null` iken menü kapalı.\n   */\n  point: { x: number; y: number } | null;\n  /** Escape, Tab, dışarı tıklama ya da seçilen eylemden sonra çağrılır; çağıran `point`i `null` yapar. */\n  onClose: () => void;\n  items: MenuItem[];\n  /** Menünün erişilebilir adı (\"Seçim seçenekleri\"). */\n  label: string;\n  /** Eylemlerin ÜSTÜNDE okunan bağlam (seçimin özeti, ölçümler) — `role=\"menu\"`nün DIŞINDA. */\n  header?: ReactNode;\n  className?: string;\n  testId?: string;\n};\n\n/* Nokta ile menu arasindaki bosluk: imlecin ucu ilk ogenin kenarini ortmesin. */\nconst POINT_OFFSET = 2;\n\n/* Menunun ICINDE sag tik tarayicinin menusunu acmaz. */\nconst preventNativeMenu = (event: MouseEvent) => event.preventDefault();\n\n/**\n * Bağlam menüsü — `Menu`nün imleç noktasında açılanı (sağ tık). Çağıran `contextmenu` olayında\n * `preventDefault()` çağırıp `point` yazar; menü noktanın sağ altına açılır, sığmazsa üste döner ve\n * görünüm alanına kırpılır. Odak açılışta ilk etkin öğeye gider, kapanışta önceki öğeye döner.\n */\nconst ContextMenuBase = ({\n  point,\n  onClose,\n  items,\n  label,\n  header,\n  className,\n  testId,\n}: ContextMenuProps) => {\n  const id = useId();\n  /*\n   * Agactaki SAHIP: noktanin DOM ogesi yok, ama portal hedefi (en yakin acik `<dialog>`) agactaki\n   * konumdan cozulur — modalin icindeki menu govdeye portallanirsa ust katmanin ALTINDA kalirdi.\n   */\n  const ownerRef = useRef<HTMLSpanElement>(null);\n  const isOpen = point !== null && enabledIndexes(items).length > 0;\n\n  const x = point?.x ?? 0;\n  const y = point?.y ?? 0;\n  const anchorRef = useMemo(\n    () => ({\n      current: { getBoundingClientRect: () => ({ top: y, left: x, width: 0, height: 0 }) },\n    }),\n    [x, y],\n  );\n\n  /*\n   * Odak YAKALAMA yuzeyin odagi tasimasindan ONCE olmali: yuzeyin `useEffect`i (ilk ogeye odak)\n   * cocukta, bu `useLayoutEffect` ise tum pasif etkilerden once kosar. Temizlik = geri yukleme\n   * (kapanis da sokulme de).\n   */\n  useLayoutEffect(() => {\n    if (!isOpen) return;\n    return captureFocus();\n  }, [isOpen]);\n\n  return (\n    <>\n      <span ref={ownerRef} hidden />\n\n      {isOpen && (\n        <MenuSurface\n          /* Yeni nokta = yeni acilis: konum yeniden olculur, odak ilk ogeye doner. */\n          key={`${x}:${y}`}\n          id={id}\n          items={items}\n          label={label}\n          anchorRef={anchorRef}\n          ownerRef={ownerRef}\n          side=\"bottom\"\n          align=\"start\"\n          offset={POINT_OFFSET}\n          initial=\"first\"\n          header={header}\n          className={className}\n          testId={testId}\n          onClose={onClose}\n          onContextMenu={preventNativeMenu}\n        />\n      )}\n    </>\n  );\n};\n\nexport const ContextMenu = /*#__PURE__*/ named(/*#__PURE__*/ memo(ContextMenuBase), 'ContextMenu');\n"],"names":["enabledIndexes","items","item","index","MenuSurface","id","label","anchorRef","ownerRef","side","align","offset","initial","header","className","testId","onClose","onContextMenu","surfaceRef","useRef","typedRef","enabled","activeIndex","setActiveIndex","useState","positioning","usePositioning","portal","usePortalSurface","isPositioned","useEffect","_b","_a","handlePointerDown","event","target","step","offsetBy","next","jumpToLetter","key","now","buffer","match","handleMenuKeyDown","buttons","jsxs","cx","styles","surface","headerId","createPortal","jsx","Menu","trigger","useId","restoreRef","opening","setOpening","isOpen","open","useCallback","captureFocus","close","handleTriggerKeyDown","isValidElement","triggerProps","anchor","cloneElement","Fragment","memo","named","POINT_OFFSET","preventNativeMenu","ContextMenuBase","point","x","y","useMemo","useLayoutEffect","ContextMenu"],"mappings":"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"}

package/build/components/Menu/index.d.ts

@@ -0,0 +1,46 @@
+import { ReactElement, ReactNode } from 'react';
+import { PositionAlign, PositionSide } from '../../types/positioning.type';
+export type MenuItem = {
+    id: string;
+    label: string;
+    icon?: ReactNode;
+    onSelect: () => void;
+    isDisabled?: boolean;
+    /** Geri alınamaz eylem: yıkıcı tonda çizilir. */
+    isDanger?: boolean;
+};
+type Props = {
+    /** Tetikleyici. */
+    trigger: ReactElement;
+    items: MenuItem[];
+    /** Menünün erişilebilir adı ("Satır eylemleri"). */
+    label: string;
+    side?: PositionSide;
+    align?: PositionAlign;
+    className?: string;
+    testId?: string;
+};
+/** Menü — bir listeden EYLEM seçme. */
+declare const Menu: ({ trigger, items, label, side, align, className, testId, }: Props) => import("react").JSX.Element | null;
+declare const _default: typeof Menu;
+export default _default;
+type ContextMenuProps = {
+    /**
+     * Açılış noktası — `contextmenu` olayının `clientX` / `clientY`si (görünüm alanı koordinatı).
+     * `null` iken menü kapalı.
+     */
+    point: {
+        x: number;
+        y: number;
+    } | null;
+    /** Escape, Tab, dışarı tıklama ya da seçilen eylemden sonra çağrılır; çağıran `point`i `null` yapar. */
+    onClose: () => void;
+    items: MenuItem[];
+    /** Menünün erişilebilir adı ("Seçim seçenekleri"). */
+    label: string;
+    /** Eylemlerin ÜSTÜNDE okunan bağlam (seçimin özeti, ölçümler) — `role="menu"`nün DIŞINDA. */
+    header?: ReactNode;
+    className?: string;
+    testId?: string;
+};
+export declare const ContextMenu: import('react').MemoExoticComponent<({ point, onClose, items, label, header, className, testId, }: ContextMenuProps) => import("react").JSX.Element>;

package/build/components/Menu/index.js

@@ -0,0 +1,241 @@
+"use client";
+import { jsxs as L, Fragment as R, jsx as x } from "react/jsx-runtime";
+import { memo as B, useId as U, useRef as M, useMemo as G, useLayoutEffect as J, useState as q, useCallback as P, useEffect as I, isValidElement as Q, cloneElement as X } from "react";
+import { createPortal as Y } from "react-dom";
+import { cx as j } from "../../helpers/class-name.helper.js";
+import { named as H } from "../../helpers/component.helper.js";
+import { captureFocus as V } from "../../helpers/focus.helper.js";
+import Z from "../../hooks/usePortalSurface.js";
+import ee from "../../hooks/usePositioning.js";
+const y = {"menu":"ui-menu-1x-FU","menu--top":"ui-menu--top-gpo39","menu--bottom":"ui-menu--bottom-6sL7b","menu--left":"ui-menu--left-4w-O8","menu--right":"ui-menu--right-XmM8G","menu__header":"ui-menu__header--yAhp","menu__list":"ui-menu__list-9nZDG","menu__item":"ui-menu__item-d1iil","menu__item--danger":"ui-menu__item--danger-lIINY","menu__icon":"ui-menu__icon-kzLV2"};
+const N = (t) => t.map((s, u) => s.isDisabled ? -1 : u).filter((s) => s >= 0), W = ({
+  id: t,
+  items: s,
+  label: u,
+  anchorRef: g,
+  ownerRef: h,
+  side: v,
+  align: _,
+  offset: w,
+  initial: m,
+  header: r,
+  className: d,
+  testId: p,
+  onClose: a,
+  onContextMenu: C
+}) => {
+  const f = M(null), D = M({ text: "", at: 0 }), o = N(s), [c, k] = q(
+    () => m === "first" ? o[0] : o[o.length - 1]
+  ), n = ee(g, f, { side: v, align: _, offset: w, isOpen: !0 }), l = Z(!0, h, f), { isPositioned: O } = n;
+  I(() => {
+    var e, i;
+    O && ((i = (e = f.current) == null ? void 0 : e.querySelector(`[data-index="${c}"]`)) == null || i.focus({ preventScroll: !0 }));
+  }, [c, O]), I(() => {
+    const e = (i) => {
+      var E, K;
+      const b = i.target;
+      (E = f.current) != null && E.contains(b) || (K = h.current) != null && K.contains(b) || a();
+    };
+    return document.addEventListener("mousedown", e), () => document.removeEventListener("mousedown", e);
+  }, [h, a]);
+  const S = (e) => {
+    const b = (o.indexOf(c) + e + o.length) % o.length;
+    k(o[b]);
+  }, z = (e) => {
+    const i = Date.now(), b = i - D.current.at > 500 ? e : D.current.text + e;
+    D.current = { text: b, at: i };
+    const E = o.find(
+      (K) => s[K].label.toLocaleLowerCase("tr").startsWith(b.toLocaleLowerCase("tr"))
+    );
+    E !== void 0 && k(E);
+  }, A = (e) => {
+    switch (e.key) {
+      case "ArrowDown":
+        e.preventDefault(), S(1);
+        break;
+      case "ArrowUp":
+        e.preventDefault(), S(-1);
+        break;
+      case "Home":
+        e.preventDefault(), k(o[0]);
+        break;
+      case "End":
+        e.preventDefault(), k(o[o.length - 1]);
+        break;
+      case "Escape":
+        e.preventDefault(), a();
+        break;
+      case "Tab":
+        a();
+        break;
+      default:
+        e.key.length === 1 && !e.metaKey && !e.ctrlKey && z(e.key);
+    }
+  };
+  if (!l.container) return null;
+  const T = s.map((e, i) => /* @__PURE__ */ L(
+    "button",
+    {
+      type: "button",
+      role: "menuitem",
+      "data-index": i,
+      tabIndex: i === c ? 0 : -1,
+      disabled: e.isDisabled,
+      className: j(y.menu__item, e.isDanger && y["menu__item--danger"]),
+      onClick: () => {
+        e.onSelect(), a();
+      },
+      children: [
+        e.icon && /* @__PURE__ */ x("span", { className: y.menu__icon, "aria-hidden": !0, children: e.icon }),
+        e.label
+      ]
+    },
+    e.id
+  )), $ = {
+    ref: f,
+    /* ⚠ Modalin ICINDEN acildiginda yuzey UST KATMANA cikmak ZORUNDA. */
+    ...l.attributes,
+    className: j(y.menu, y[`menu--${n.side}`], d),
+    style: {
+      ...n.style,
+      ...l.style,
+      visibility: n.isPositioned ? "visible" : "hidden"
+    },
+    "data-testid": p,
+    onContextMenu: C
+  }, F = `${t}-header`;
+  return Y(
+    /*
+     * BASLIK `role="menu"`nun DISINDA: menu yalniz `menuitem` tasir. Baslik menuye
+     * `aria-describedby` ile baglanir — ok tuslari ogeler arasinda gezerken baglam okunur.
+     */
+    r ? /* @__PURE__ */ L("div", { ...$, children: [
+      /* @__PURE__ */ x("div", { id: F, className: y.menu__header, children: r }),
+      /* @__PURE__ */ x(
+        "div",
+        {
+          id: t,
+          role: "menu",
+          "aria-label": u,
+          "aria-describedby": F,
+          className: y.menu__list,
+          onKeyDown: A,
+          children: T
+        }
+      )
+    ] }) : /* @__PURE__ */ x("div", { ...$, id: t, role: "menu", "aria-label": u, onKeyDown: A, children: T }),
+    l.container
+  );
+}, ne = ({
+  trigger: t,
+  items: s,
+  label: u,
+  side: g = "bottom",
+  align: h = "start",
+  className: v,
+  testId: _
+}) => {
+  const w = U(), m = M(null), r = M(null), [d, p] = q(null), a = d !== null, C = N(s), f = P(
+    (n) => {
+      C.length !== 0 && (r.current = V(), p(n));
+    },
+    [C]
+  ), D = P(() => {
+    var n;
+    p(null), (n = r.current) == null || n.call(r), r.current = null;
+  }, []);
+  I(
+    () => () => {
+      var n;
+      (n = r.current) == null || n.call(r), r.current = null;
+    },
+    []
+  );
+  const o = (n) => {
+    if (n.key === "ArrowUp") {
+      n.preventDefault(), f("last");
+      return;
+    }
+    ["ArrowDown", "Enter", " "].includes(n.key) && (n.preventDefault(), f("first"));
+  };
+  if (!Q(t)) return null;
+  const c = t.props, k = X(t, {
+    ref: m,
+    "aria-haspopup": "menu",
+    "aria-expanded": a,
+    "aria-controls": a ? w : void 0,
+    onClick: (n) => {
+      var l;
+      (l = c.onClick) == null || l.call(c, n), a ? D() : f("first");
+    },
+    onKeyDown: (n) => {
+      var l;
+      (l = c.onKeyDown) == null || l.call(c, n), a || o(n);
+    }
+  });
+  return /* @__PURE__ */ L(R, { children: [
+    k,
+    d && /* @__PURE__ */ x(
+      W,
+      {
+        id: w,
+        items: s,
+        label: u,
+        anchorRef: m,
+        ownerRef: m,
+        side: g,
+        align: h,
+        initial: d,
+        className: v,
+        testId: _,
+        onClose: D
+      }
+    )
+  ] });
+}, pe = /* @__PURE__ */ B(/* @__PURE__ */ H(ne, "Menu")), te = 2, re = (t) => t.preventDefault(), oe = ({
+  point: t,
+  onClose: s,
+  items: u,
+  label: g,
+  header: h,
+  className: v,
+  testId: _
+}) => {
+  const w = U(), m = M(null), r = t !== null && N(u).length > 0, d = (t == null ? void 0 : t.x) ?? 0, p = (t == null ? void 0 : t.y) ?? 0, a = G(
+    () => ({
+      current: { getBoundingClientRect: () => ({ top: p, left: d, width: 0, height: 0 }) }
+    }),
+    [d, p]
+  );
+  return J(() => {
+    if (r)
+      return V();
+  }, [r]), /* @__PURE__ */ L(R, { children: [
+    /* @__PURE__ */ x("span", { ref: m, hidden: !0 }),
+    r && /* @__PURE__ */ x(
+      W,
+      {
+        id: w,
+        items: u,
+        label: g,
+        anchorRef: a,
+        ownerRef: m,
+        side: "bottom",
+        align: "start",
+        offset: te,
+        initial: "first",
+        header: h,
+        className: v,
+        testId: _,
+        onClose: s,
+        onContextMenu: re
+      },
+      `${d}:${p}`
+    )
+  ] });
+}, he = /* @__PURE__ */ H(/* @__PURE__ */ B(oe), "ContextMenu");
+export {
+  he as ContextMenu,
+  pe as default
+};
+//# sourceMappingURL=index.js.map

package/build/components/Menu/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/components/Menu/index.tsx"],"sourcesContent":["'use client';\n\nimport {\n  cloneElement,\n  isValidElement,\n  type KeyboardEvent,\n  memo,\n  type MouseEvent,\n  type ReactElement,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useId,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { createPortal } from 'react-dom';\n\nimport { cx } from '../../helpers/class-name.helper';\nimport { named } from '../../helpers/component.helper';\nimport { captureFocus } from '../../helpers/focus.helper';\nimport usePortalSurface from '../../hooks/usePortalSurface';\nimport usePositioning from '../../hooks/usePositioning';\n\nimport styles from './index.module.scss';\nimport type { PositionAlign, PositionSide, PositioningRect } from '@/types/positioning.type';\n\nexport type MenuItem = {\n  id: string;\n  label: string;\n  icon?: ReactNode;\n  onSelect: () => void;\n  isDisabled?: boolean;\n  /** Geri alınamaz eylem: yıkıcı tonda çizilir. */\n  isDanger?: boolean;\n};\n\ntype Props = {\n  /** Tetikleyici. */\n  trigger: ReactElement;\n  items: MenuItem[];\n  /** Menünün erişilebilir adı (\"Satır eylemleri\"). */\n  label: string;\n  side?: PositionSide;\n  align?: PositionAlign;\n  className?: string;\n  testId?: string;\n};\n\n/** Pasif olmayan seçeneklerin dizinleri. */\nconst enabledIndexes = (items: MenuItem[]): number[] =>\n  items.map((item, index) => (item.isDisabled ? -1 : index)).filter(index => index >= 0);\n\ntype SurfaceProps = {\n  id: string;\n  items: MenuItem[];\n  label: string;\n  /** Konumun ÖLÇÜLDÜĞÜ çapa: tetikleyici ya da imleç noktası. */\n  anchorRef: { current: { getBoundingClientRect: () => PositioningRect } | null };\n  /** Ağaçtaki sahip: portal hedefi (en yakın `<dialog>`) ve dışarı-tıklama istisnası. */\n  ownerRef: { current: HTMLElement | null };\n  side: PositionSide;\n  align: PositionAlign;\n  offset?: number;\n  /** Açılışta odaklanan uç. */\n  initial: 'first' | 'last';\n  header?: ReactNode;\n  className?: string;\n  testId?: string;\n  onClose: () => void;\n  onContextMenu?: (event: MouseEvent) => void;\n};\n\n/**\n * MENÜ YÜZEYİ — `Menu` ve `ContextMenu`nün ortak gövdesi: konum, portal, odak, klavye ve\n * dışarı-tıklama TEK yerde. Yalnızca AÇIKKEN takılır; kapanış sökülmedir.\n */\nconst MenuSurface = ({\n  id,\n  items,\n  label,\n  anchorRef,\n  ownerRef,\n  side,\n  align,\n  offset,\n  initial,\n  header,\n  className,\n  testId,\n  onClose,\n  onContextMenu,\n}: SurfaceProps) => {\n  const surfaceRef = useRef<HTMLDivElement>(null);\n  /* Harfe atlama tamponu: art arda basilan harfler tek bir arama olur. */\n  const typedRef = useRef({ text: '', at: 0 });\n  const enabled = enabledIndexes(items);\n\n  const [activeIndex, setActiveIndex] = useState(() =>\n    initial === 'first' ? enabled[0] : enabled[enabled.length - 1],\n  );\n\n  const positioning = usePositioning(anchorRef, surfaceRef, { side, align, offset, isOpen: true });\n\n  /*\n   * Portal hedefi HER RENDER'DA degil, yalnizca acikken cozulur. `closest` ucuzdur ama\n   * tetikleyicinin DOM konumu acilistan sonra degismedigi icin tekrar…\n   */\n  const portal = usePortalSurface(true, ownerRef, surfaceRef);\n\n  /*\n   * Etkin oge GERCEKTEN odaklanir (APG menu deseni).\n   * ⚠ KONUM OLCULDUKTEN SONRA: yuzey o ana kadar `visibility: hidden` tasir ve gizli oge odak ALMAZ.\n   * Olcum `useLayoutEffect`te durum yazar, ama ayrik olayda (tik, sag tik) React bu commit'in pasif\n   * etkilerini yeniden cizimden ONCE bosaltiyor — odak gizli yuzeye gidip sessizce dusuyordu ve\n   * odak `<body>`de kaliyordu (olculdu: chromium, 5.5.0 `Menu` dahil). jsdom gorunurlugu bilmedigi\n   * icin birim testleri bunu goremiyordu; nobetci `anchored-panel.spec.ts` \"menü açılışında odak\".\n   */\n  const { isPositioned } = positioning;\n\n  useEffect(() => {\n    if (!isPositioned) return;\n    surfaceRef.current\n      ?.querySelector<HTMLElement>(`[data-index=\"${activeIndex}\"]`)\n      ?.focus({ preventScroll: true });\n  }, [activeIndex, isPositioned]);\n\n  useEffect(() => {\n    const handlePointerDown = (event: globalThis.MouseEvent) => {\n      const target = event.target as Node;\n      if (surfaceRef.current?.contains(target) || ownerRef.current?.contains(target)) return;\n      onClose();\n    };\n\n    document.addEventListener('mousedown', handlePointerDown);\n    return () => document.removeEventListener('mousedown', handlePointerDown);\n  }, [ownerRef, onClose]);\n\n  const step = (offsetBy: number) => {\n    const position = enabled.indexOf(activeIndex);\n    const next = (position + offsetBy + enabled.length) % enabled.length;\n    setActiveIndex(enabled[next]);\n  };\n\n  /** Harfe atlama: 500 ms içinde basılan harfler tek bir arama. */\n  const jumpToLetter = (key: string) => {\n    const now = Date.now();\n    const buffer = now - typedRef.current.at > 500 ? key : typedRef.current.text + key;\n    typedRef.current = { text: buffer, at: now };\n\n    const match = enabled.find(index =>\n      items[index].label.toLocaleLowerCase('tr').startsWith(buffer.toLocaleLowerCase('tr')),\n    );\n\n    if (match !== undefined) setActiveIndex(match);\n  };\n\n  const handleMenuKeyDown = (event: KeyboardEvent) => {\n    switch (event.key) {\n      case 'ArrowDown':\n        event.preventDefault();\n        step(1);\n        break;\n\n      case 'ArrowUp':\n        event.preventDefault();\n        step(-1);\n        break;\n\n      case 'Home':\n        event.preventDefault();\n        setActiveIndex(enabled[0]);\n        break;\n\n      case 'End':\n        event.preventDefault();\n        setActiveIndex(enabled[enabled.length - 1]);\n        break;\n\n      case 'Escape':\n        /*\n         * `preventDefault` SAYFAYA \"bu Escape islendi\" der: `window`da Escape dinleyen kod\n         * (`event.defaultPrevented`) menuyu kapatan tusla kendi eylemini de calistirmaz.\n         */\n        event.preventDefault();\n        onClose();\n        break;\n\n      case 'Tab':\n        /*\n         * Menu KAPANIR ama gezinme SURER: kullanici menuden cikip sayfaya devam ediyor.\n         * `preventDefault` yok.\n         */\n        onClose();\n        break;\n\n      default:\n        if (event.key.length === 1 && !event.metaKey && !event.ctrlKey) jumpToLetter(event.key);\n    }\n  };\n\n  if (!portal.container) return null;\n\n  const buttons = items.map((item, index) => (\n    <button\n      key={item.id}\n      type=\"button\"\n      role=\"menuitem\"\n      data-index={index}\n      /* DONEN `tabindex`: menu Tab sirasinda TEK durak. */\n      tabIndex={index === activeIndex ? 0 : -1}\n      disabled={item.isDisabled}\n      className={cx(styles.menu__item, item.isDanger && styles['menu__item--danger'])}\n      onClick={() => {\n        item.onSelect();\n        onClose();\n      }}\n      /*\n       * ⚠ `onMouseEnter` KALDIRILDI. Eskiden fare bir ogenin uzerine\n       * geldiginde `setActiveIndex` cagriliyordu; asagidaki etki de\n       * `activeIndex` degisince `.focus()` cagirdigi icin sonuc\n       * **farenin klavye odagini calmasi** oluyordu: kullanici ok\n       * tuslariyla gezinirken imlecin durdugu yer ya da menunun\n       * imlecin altinda kaymasi odagi geri firlatiyordu.\n       *\n       * Kaldirilan yorumun gerekcesi \"iki ayri vurgu kullaniciyi\n       * sasirtiyordu\" idi; o sorun VURGULARI AYIRARAK cozuldu:\n       * hover = arka plan, klavye odagi = halka (`index.module.scss`).\n       * Ikisi artik farkli sey soyluyor, cakismiyor.\n       */\n    >\n      {item.icon && (\n        <span className={styles.menu__icon} aria-hidden>\n          {item.icon}\n        </span>\n      )}\n      {item.label}\n    </button>\n  ));\n\n  const surface = {\n    ref: surfaceRef,\n    /* ⚠ Modalin ICINDEN acildiginda yuzey UST KATMANA cikmak ZORUNDA. */\n    ...portal.attributes,\n    className: cx(styles.menu, styles[`menu--${positioning.side}`], className),\n    style: {\n      ...positioning.style,\n      ...portal.style,\n      visibility: positioning.isPositioned ? ('visible' as const) : ('hidden' as const),\n    },\n    'data-testid': testId,\n    onContextMenu,\n  };\n\n  const headerId = `${id}-header`;\n\n  return createPortal(\n    /*\n     * BASLIK `role=\"menu\"`nun DISINDA: menu yalniz `menuitem` tasir. Baslik menuye\n     * `aria-describedby` ile baglanir — ok tuslari ogeler arasinda gezerken baglam okunur.\n     */\n    header ? (\n      <div {...surface}>\n        <div id={headerId} className={styles.menu__header}>\n          {header}\n        </div>\n        <div\n          id={id}\n          role=\"menu\"\n          aria-label={label}\n          aria-describedby={headerId}\n          className={styles.menu__list}\n          onKeyDown={handleMenuKeyDown}\n        >\n          {buttons}\n        </div>\n      </div>\n    ) : (\n      <div {...surface} id={id} role=\"menu\" aria-label={label} onKeyDown={handleMenuKeyDown}>\n        {buttons}\n      </div>\n    ),\n    portal.container,\n  );\n};\n\n/** Menü — bir listeden EYLEM seçme. */\nconst Menu = ({\n  trigger,\n  items,\n  label,\n  side = 'bottom',\n  align = 'start',\n  className,\n  testId,\n}: Props) => {\n  const id = useId();\n  const anchorRef = useRef<HTMLElement>(null);\n  const restoreRef = useRef<(() => void) | null>(null);\n\n  /* Acilisin hangi uca odaklanacagi; `null` = kapali. */\n  const [opening, setOpening] = useState<'first' | 'last' | null>(null);\n  const isOpen = opening !== null;\n  const enabled = enabledIndexes(items);\n\n  const open = useCallback(\n    (target: 'first' | 'last') => {\n      if (enabled.length === 0) return;\n      restoreRef.current = captureFocus();\n      setOpening(target);\n    },\n    [enabled],\n  );\n\n  const close = useCallback(() => {\n    setOpening(null);\n    /*\n     * Odak TETIKLEYICIYE doner: donmezse `<body>`ye duser ve klavye kullanicisi sayfanin en basina\n     * giderdi.\n     */\n    restoreRef.current?.();\n    restoreRef.current = null;\n  }, []);\n\n  /*\n   * Geri yukleme YALNIZCA `close()` icindeydi, yani menu ACIKKEN sokuldugunde hic calismiyordu.\n   * ⚠ SOKULME de bir kapanistir.\n   */\n  useEffect(\n    () => () => {\n      restoreRef.current?.();\n      restoreRef.current = null;\n    },\n    [],\n  );\n\n  const handleTriggerKeyDown = (event: KeyboardEvent) => {\n    if (event.key === 'ArrowUp') {\n      event.preventDefault();\n      open('last');\n      return;\n    }\n\n    if (['ArrowDown', 'Enter', ' '].includes(event.key)) {\n      event.preventDefault();\n      open('first');\n    }\n  };\n\n  if (!isValidElement(trigger)) return null;\n\n  const triggerProps = trigger.props as Record<string, unknown>;\n\n  const anchor = cloneElement(trigger as ReactElement<Record<string, unknown>>, {\n    ref: anchorRef,\n    'aria-haspopup': 'menu',\n    'aria-expanded': isOpen,\n    'aria-controls': isOpen ? id : undefined,\n    onClick: (event: MouseEvent) => {\n      (triggerProps.onClick as ((event: MouseEvent) => void) | undefined)?.(event);\n      if (isOpen) close();\n      else open('first');\n    },\n    onKeyDown: (event: KeyboardEvent) => {\n      (triggerProps.onKeyDown as ((event: KeyboardEvent) => void) | undefined)?.(event);\n      if (!isOpen) handleTriggerKeyDown(event);\n    },\n  });\n\n  return (\n    <>\n      {anchor}\n\n      {opening && (\n        <MenuSurface\n          id={id}\n          items={items}\n          label={label}\n          anchorRef={anchorRef}\n          ownerRef={anchorRef}\n          side={side}\n          align={align}\n          initial={opening}\n          className={className}\n          testId={testId}\n          onClose={close}\n        />\n      )}\n    </>\n  );\n};\n\nexport default /*#__PURE__*/ memo(/*#__PURE__*/ named(Menu, 'Menu')) as typeof Menu;\n\ntype ContextMenuProps = {\n  /**\n   * Açılış noktası — `contextmenu` olayının `clientX` / `clientY`si (görünüm alanı koordinatı).\n   * `null` iken menü kapalı.\n   */\n  point: { x: number; y: number } | null;\n  /** Escape, Tab, dışarı tıklama ya da seçilen eylemden sonra çağrılır; çağıran `point`i `null` yapar. */\n  onClose: () => void;\n  items: MenuItem[];\n  /** Menünün erişilebilir adı (\"Seçim seçenekleri\"). */\n  label: string;\n  /** Eylemlerin ÜSTÜNDE okunan bağlam (seçimin özeti, ölçümler) — `role=\"menu\"`nün DIŞINDA. */\n  header?: ReactNode;\n  className?: string;\n  testId?: string;\n};\n\n/* Nokta ile menu arasindaki bosluk: imlecin ucu ilk ogenin kenarini ortmesin. */\nconst POINT_OFFSET = 2;\n\n/* Menunun ICINDE sag tik tarayicinin menusunu acmaz. */\nconst preventNativeMenu = (event: MouseEvent) => event.preventDefault();\n\n/**\n * Bağlam menüsü — `Menu`nün imleç noktasında açılanı (sağ tık). Çağıran `contextmenu` olayında\n * `preventDefault()` çağırıp `point` yazar; menü noktanın sağ altına açılır, sığmazsa üste döner ve\n * görünüm alanına kırpılır. Odak açılışta ilk etkin öğeye gider, kapanışta önceki öğeye döner.\n */\nconst ContextMenuBase = ({\n  point,\n  onClose,\n  items,\n  label,\n  header,\n  className,\n  testId,\n}: ContextMenuProps) => {\n  const id = useId();\n  /*\n   * Agactaki SAHIP: noktanin DOM ogesi yok, ama portal hedefi (en yakin acik `<dialog>`) agactaki\n   * konumdan cozulur — modalin icindeki menu govdeye portallanirsa ust katmanin ALTINDA kalirdi.\n   */\n  const ownerRef = useRef<HTMLSpanElement>(null);\n  const isOpen = point !== null && enabledIndexes(items).length > 0;\n\n  const x = point?.x ?? 0;\n  const y = point?.y ?? 0;\n  const anchorRef = useMemo(\n    () => ({\n      current: { getBoundingClientRect: () => ({ top: y, left: x, width: 0, height: 0 }) },\n    }),\n    [x, y],\n  );\n\n  /*\n   * Odak YAKALAMA yuzeyin odagi tasimasindan ONCE olmali: yuzeyin `useEffect`i (ilk ogeye odak)\n   * cocukta, bu `useLayoutEffect` ise tum pasif etkilerden once kosar. Temizlik = geri yukleme\n   * (kapanis da sokulme de).\n   */\n  useLayoutEffect(() => {\n    if (!isOpen) return;\n    return captureFocus();\n  }, [isOpen]);\n\n  return (\n    <>\n      <span ref={ownerRef} hidden />\n\n      {isOpen && (\n        <MenuSurface\n          /* Yeni nokta = yeni acilis: konum yeniden olculur, odak ilk ogeye doner. */\n          key={`${x}:${y}`}\n          id={id}\n          items={items}\n          label={label}\n          anchorRef={anchorRef}\n          ownerRef={ownerRef}\n          side=\"bottom\"\n          align=\"start\"\n          offset={POINT_OFFSET}\n          initial=\"first\"\n          header={header}\n          className={className}\n          testId={testId}\n          onClose={onClose}\n          onContextMenu={preventNativeMenu}\n        />\n      )}\n    </>\n  );\n};\n\nexport const ContextMenu = /*#__PURE__*/ named(/*#__PURE__*/ memo(ContextMenuBase), 'ContextMenu');\n"],"names":["enabledIndexes","items","item","index","MenuSurface","id","label","anchorRef","ownerRef","side","align","offset","initial","header","className","testId","onClose","onContextMenu","surfaceRef","useRef","typedRef","enabled","activeIndex","setActiveIndex","useState","positioning","usePositioning","portal","usePortalSurface","isPositioned","useEffect","_b","_a","handlePointerDown","event","target","step","offsetBy","next","jumpToLetter","key","now","buffer","match","handleMenuKeyDown","buttons","jsxs","cx","styles","surface","headerId","createPortal","jsx","Menu","trigger","useId","restoreRef","opening","setOpening","isOpen","open","useCallback","captureFocus","close","handleTriggerKeyDown","isValidElement","triggerProps","anchor","cloneElement","Fragment","memo","named","POINT_OFFSET","preventNativeMenu","ContextMenuBase","point","x","y","useMemo","useLayoutEffect","ContextMenu"],"mappings":"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"}

package/build/components/Menu/style.css

@@ -0,0 +1 @@
+@layer ui{.ui-menu-1x-FU{display:flex;flex-direction:column;gap:2px;z-index:200;min-width:180px;max-width:min(320px,100vw - var(--ui-space-6));max-height:min(60dvh,420px);overflow-y:auto;padding:var(--ui-space-1);border-radius:var(--ui-radius-md);background-color:var(--ui-surface);border:1px solid var(--ui-border);box-shadow:var(--ui-shadow-lg);scrollbar-width:thin;scrollbar-color:var(--ui-border-strong) transparent}.ui-menu-1x-FU::-webkit-scrollbar{width:8px;height:8px}.ui-menu-1x-FU::-webkit-scrollbar-track{background:transparent}.ui-menu-1x-FU::-webkit-scrollbar-thumb{background-color:var(--ui-border-strong);border-radius:var(--ui-radius-pill);border:2px solid transparent;background-clip:content-box}.ui-menu-1x-FU::-webkit-scrollbar-thumb:hover{background-color:var(--ui-text-3)}.ui-menu--top-gpo39{animation:var(--ui-anim-fade-in-up) var(--ui-duration-fast) var(--ui-ease-out)}.ui-menu--bottom-6sL7b{animation:var(--ui-anim-fade-in-down) var(--ui-duration-fast) var(--ui-ease-out)}.ui-menu--left-4w-O8,.ui-menu--right-XmM8G{animation:var(--ui-anim-fade-in) var(--ui-duration-fast) var(--ui-ease-out)}@media (prefers-reduced-motion: reduce){.ui-menu-1x-FU{animation:none}}@media (forced-colors: active){.ui-menu-1x-FU{border-color:CanvasText}}.ui-menu__header--yAhp{padding:var(--ui-space-2) var(--ui-space-3);margin-bottom:var(--ui-space-1);border-bottom:1px solid var(--ui-border);font-family:var(--ui-font-body);font-size:var(--ui-font-size-sm);color:var(--ui-text-2)}.ui-menu__list-9nZDG{display:flex;flex-direction:column;gap:2px}.ui-menu__item-d1iil{display:flex;align-items:center;gap:var(--ui-space-2);width:100%;min-height:40px;padding:var(--ui-space-2) var(--ui-space-3);border:none;border-radius:var(--ui-radius-sm);background:none;cursor:pointer;text-align:start;font-family:var(--ui-font-body);font-size:var(--ui-font-size-sm);color:var(--ui-text);background-color:transparent;transition:background-color var(--ui-duration-fast) var(--ui-ease-out),translate var(--ui-duration-instant) var(--ui-ease-out)}.ui-menu__item-d1iil:hover:not(:disabled):not([aria-disabled=true]){background-color:var(--ui-surface-2)}.ui-menu__item-d1iil:active:not(:disabled):not([aria-disabled=true]){background-color:var(--ui-surface-3);translate:0 1px}@media (prefers-reduced-motion: reduce){.ui-menu__item-d1iil{transition:none}.ui-menu__item-d1iil:active:not(:disabled):not([aria-disabled=true]){translate:none}}.ui-menu__item-d1iil:focus{outline:none}.ui-menu__item-d1iil:focus-visible{outline:var(--ui-ring-width, 2px) solid var(--ui-ring-color);outline-offset:var(--ui-ring-offset, -2px)}.ui-menu__item-d1iil:focus-visible{background-color:var(--ui-surface-2)}.ui-menu__item-d1iil:disabled{color:var(--ui-text-3);cursor:not-allowed}.ui-menu__item--danger-lIINY{color:var(--ui-bad-fg)}.ui-menu__item--danger-lIINY:hover:not(:disabled),.ui-menu__item--danger-lIINY:focus-visible{background-color:var(--ui-bad-bg)}@media (prefers-reduced-motion: reduce){.ui-menu__item-d1iil{transition:none}}@media (forced-colors: active){.ui-menu__item-d1iil:focus-visible{outline:var(--ui-ring-width, 2px) solid Highlight;outline-offset:var(--ui-ring-offset, -2px)}}.ui-menu__icon-kzLV2{display:inline-flex;flex-shrink:0;font-size:var(--ui-icon-sm);color:var(--ui-text-2)}}

package/build/components/Modal/index.cjs

@@ -0,0 +1,2 @@
+"use client";"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const a=require("react/jsx-runtime"),l=require("react"),I=require("react-bootstrap-icons"),v=require("../../helpers/class-name.helper.cjs"),o=require("../../helpers/focus.helper.cjs"),R=require("../../helpers/label.helper.cjs"),E=require("../../hooks/useScrollLock.cjs"),$=require("../../theme/context.cjs"),F=require("../IconButton/index.cjs"),t={default:{"modal":"ui-modal-3IDi9","modal--sm":"ui-modal--sm-A7WsS","modal--lg":"ui-modal--lg-z99Em","modal--xl":"ui-modal--xl-g3d6F","modal__panel":"ui-modal__panel--qLSz","modal__header":"ui-modal__header-meWm6","modal__icon":"ui-modal__icon-df2dd","modal__icon--neutral":"ui-modal__icon--neutral-QSL7c","modal__icon--danger":"ui-modal__icon--danger-6V90a","modal__icon--warning":"ui-modal__icon--warning-a--FX","modal__icon--success":"ui-modal__icon--success-YWxZs","modal__icon--info":"ui-modal__icon--info-WRLah","modal__heading":"ui-modal__heading-PwDS8","modal__title":"ui-modal__title-80Sh6","modal__description":"ui-modal__description-fsCHI","modal__close":"ui-modal__close-vFPbw","modal__body":"ui-modal__body-PDF12","modal__footer":"ui-modal__footer-CCCkx"}},S=({isOpen:u,onClose:r,title:g,closeLabel:N,children:_,description:i,footer:h,icon:x,tone:q="neutral",size:M="md",isDismissable:c=!0,className:b,testId:k})=>{const{labels:f}=$.useUi(),d=l.useRef(null),n=l.useRef(null),p=l.useId(),j=l.useId();l.useEffect(()=>{const e=d.current;if(!e)return;if(!u){e.open&&e.close();return}const s=o.captureFocus();e.open||e.showModal(),o.focusFirstMeaningful(e,`.${t.default.modal__close}`),o.preventAutoKeyboard(e);const{token:m,pop:y}=o.pushModal();return n.current=m,()=>{y(),n.current=null,s()}},[u]),E.default(u),l.useEffect(()=>{const e=d.current;if(!e)return;const s=m=>{m.preventDefault(),c&&(n.current&&!o.isTopModal(n.current)||r())};return e.addEventListener("cancel",s),()=>e.removeEventListener("cancel",s)},[r,c]);const L=l.useCallback(e=>{c&&e.target===d.current&&r()},[c,r]);return a.jsx("dialog",{ref:d,className:v.cx(t.default.modal,t.default[`modal--${M}`],b),"aria-labelledby":p,"aria-describedby":i?j:void 0,"data-testid":k,onClick:L,children:a.jsxs("div",{className:t.default.modal__panel,children:[a.jsxs("header",{className:t.default.modal__header,children:[x&&a.jsx("span",{className:v.cx(t.default.modal__icon,t.default[`modal__icon--${q}`]),children:x}),a.jsxs("div",{className:t.default.modal__heading,children:[a.jsx("h2",{id:p,className:t.default.modal__title,children:g}),i&&a.jsx("p",{id:j,className:t.default.modal__description,children:i})]}),c&&a.jsx(F.default,{icon:a.jsx(I.XLg,{"aria-hidden":!0}),label:R.resolveLabel("Modal.closeLabel",N,f==null?void 0:f.close),variant:"ghost",size:"sm",className:t.default.modal__close,onClick:r})]}),_&&a.jsx("div",{className:t.default.modal__body,children:_}),h&&a.jsx("footer",{className:t.default.modal__footer,children:h})]})})},B=l.memo(S);exports.default=B;
+//# sourceMappingURL=index.cjs.map

package/build/components/Modal/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../src/components/Modal/index.tsx"],"sourcesContent":["'use client';\n\nimport {\n  memo,\n  type MouseEvent,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useId,\n  useRef,\n} from 'react';\n\nimport { XLg } from 'react-bootstrap-icons';\n\nimport { cx } from '../../helpers/class-name.helper';\nimport {\n  captureFocus,\n  focusFirstMeaningful,\n  isTopModal,\n  preventAutoKeyboard,\n  pushModal,\n} from '../../helpers/focus.helper';\nimport { resolveLabel } from '../../helpers/label.helper';\nimport useScrollLock from '../../hooks/useScrollLock';\nimport { useUi } from '../../theme/context';\nimport IconButton from '../IconButton';\n\nimport styles from './index.module.scss';\n\nexport type ModalTone = 'neutral' | 'danger' | 'warning' | 'success' | 'info';\n\ntype Props = {\n  isOpen: boolean;\n  onClose: () => void;\n  title: string;\n  /** Kapatma düğmesinin erişilebilir adı. */\n  closeLabel?: string;\n  children?: ReactNode;\n  /** Başlığın altındaki bir cümlelik açıklama. */\n  description?: ReactNode;\n  /** Altta duran eylemler. */\n  footer?: ReactNode;\n  /** Başlığın solunda duran ikon madalyonu; `tone` rengini alır. */\n  icon?: ReactNode;\n  /** İkon madalyonunun tonu. */\n  tone?: ModalTone;\n  /** `xl` (≈1040 px) sekmeli, tablolu panolar için; dar ekranda diğerleri gibi tam genişlik. */\n  size?: 'sm' | 'md' | 'lg' | 'xl';\n  /** `false` iken arka plana tıklama, Escape ve kapatma düğmesi kapatmaz. */\n  isDismissable?: boolean;\n  className?: string;\n  testId?: string;\n};\n\n/** Kip pencere (modal). */\nconst Modal = ({\n  isOpen,\n  onClose,\n  title,\n  closeLabel,\n  children,\n  description,\n  footer,\n  icon,\n  tone = 'neutral',\n  size = 'md',\n  isDismissable = true,\n  className,\n  testId,\n}: Props) => {\n  const { labels } = useUi();\n  const dialogRef = useRef<HTMLDialogElement>(null);\n  /* Yigindaki yerimiz: */\n  const tokenRef = useRef<symbol | null>(null);\n  const titleId = useId();\n  const descriptionId = useId();\n\n  /* ACILIS: `showModal()` + odak + yigina katilma. */\n  useEffect(() => {\n    const dialog = dialogRef.current;\n    if (!dialog) return;\n\n    if (!isOpen) {\n      if (dialog.open) dialog.close();\n      return;\n    }\n\n    const restoreFocus = captureFocus();\n    if (!dialog.open) dialog.showModal();\n\n    /*\n     * Odak KAPATMA DUGMESINE degil ilk anlamli ogeye. `showModal()` DOM sirasindaki ilk\n     * odaklanabilir ogeye gidiyor ve o neredeyse her zaman basliktaki…\n     */\n    focusFirstMeaningful(dialog, `.${styles.modal__close}`);\n    /*\n     * Odak bir metin alanina dustuyse geri alinir: telefonda ekran klavyesi kullanici istemeden\n     * aciliyordu (bkz. `helpers/focus.helper`).\n     */\n    preventAutoKeyboard(dialog);\n\n    const { token, pop } = pushModal();\n    tokenRef.current = token;\n\n    return () => {\n      pop();\n      tokenRef.current = null;\n      restoreFocus();\n    };\n  }, [isOpen]);\n\n  /*\n   * Arka plan kaydirmasi kilitlenir. `showModal()` arka plani etkilesime kapatir ama kaydirmayi her\n   * tarayicida engellemiyor: kullanici pencereyi…\n   */\n  useScrollLock(isOpen);\n\n  /*\n   * Escape'i tarayici isliyor ama React durumu bundan haberdar olmuyor; `cancel` olayi yakalanmazsa\n   * pencere kapanip `isOpen` true kaliyor ve bir daha…\n   */\n  useEffect(() => {\n    const dialog = dialogRef.current;\n    if (!dialog) return;\n\n    const handleCancel = (event: Event) => {\n      /*\n       * Varsayilan HER ZAMAN engellenir: kapanis karari React'te veriliyor ve tarayicinin pencereyi\n       * kendi basina kapatmasi durumu `isOpen: true` birakiyordu.\n       */\n      event.preventDefault();\n      if (!isDismissable) return;\n\n      /* Yalnizca EN USTTEKI panel kapanir. */\n      if (tokenRef.current && !isTopModal(tokenRef.current)) return;\n\n      onClose();\n    };\n\n    dialog.addEventListener('cancel', handleCancel);\n    return () => dialog.removeEventListener('cancel', handleCancel);\n  }, [onClose, isDismissable]);\n\n  const handleBackdropClick = useCallback(\n    (event: MouseEvent<HTMLDialogElement>) => {\n      if (!isDismissable) return;\n      // Hedef dialog'un KENDISI ise arka plana tiklanmistir; panel degil.\n      if (event.target === dialogRef.current) onClose();\n    },\n    [isDismissable, onClose],\n  );\n\n  return (\n    <dialog\n      ref={dialogRef}\n      className={cx(styles.modal, styles[`modal--${size}`], className)}\n      aria-labelledby={titleId}\n      aria-describedby={description ? descriptionId : undefined}\n      data-testid={testId}\n      onClick={handleBackdropClick}\n    >\n      <div className={styles.modal__panel}>\n        <header className={styles.modal__header}>\n          {icon && (\n            <span className={cx(styles.modal__icon, styles[`modal__icon--${tone}`])}>{icon}</span>\n          )}\n\n          <div className={styles.modal__heading}>\n            <h2 id={titleId} className={styles.modal__title}>\n              {title}\n            </h2>\n            {description && (\n              <p id={descriptionId} className={styles.modal__description}>\n                {description}\n              </p>\n            )}\n          </div>\n\n          {isDismissable && (\n            <IconButton\n              icon={<XLg aria-hidden />}\n              label={resolveLabel('Modal.closeLabel', closeLabel, labels?.close)}\n              variant=\"ghost\"\n              size=\"sm\"\n              className={styles.modal__close}\n              onClick={onClose}\n            />\n          )}\n        </header>\n\n        {/*\n          Gövde yalnızca içerik VARSA çizilir: onay pencerelerinin çoğunda soru\n          başlıkta ve açıklamada duruyor, gövde boş kalıyor ve boş bir kutu\n          40 px'lik bir boşluk bırakıyordu.\n        */}\n        {children && <div className={styles.modal__body}>{children}</div>}\n\n        {footer && <footer className={styles.modal__footer}>{footer}</footer>}\n      </div>\n    </dialog>\n  );\n};\n\nexport default /*#__PURE__*/ memo(Modal) as typeof Modal;\n"],"names":["Modal","isOpen","onClose","title","closeLabel","children","description","footer","icon","tone","size","isDismissable","className","testId","labels","useUi","dialogRef","useRef","tokenRef","titleId","useId","descriptionId","useEffect","dialog","restoreFocus","captureFocus","focusFirstMeaningful","styles","preventAutoKeyboard","token","pop","pushModal","useScrollLock","handleCancel","event","isTopModal","handleBackdropClick","useCallback","jsx","cx","jsxs","IconButton","XLg","resolveLabel"],"mappings":"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"}

package/build/components/Modal/index.d.ts

@@ -0,0 +1,28 @@
+import { ReactNode } from 'react';
+export type ModalTone = 'neutral' | 'danger' | 'warning' | 'success' | 'info';
+type Props = {
+    isOpen: boolean;
+    onClose: () => void;
+    title: string;
+    /** Kapatma düğmesinin erişilebilir adı. */
+    closeLabel?: string;
+    children?: ReactNode;
+    /** Başlığın altındaki bir cümlelik açıklama. */
+    description?: ReactNode;
+    /** Altta duran eylemler. */
+    footer?: ReactNode;
+    /** Başlığın solunda duran ikon madalyonu; `tone` rengini alır. */
+    icon?: ReactNode;
+    /** İkon madalyonunun tonu. */
+    tone?: ModalTone;
+    /** `xl` (≈1040 px) sekmeli, tablolu panolar için; dar ekranda diğerleri gibi tam genişlik. */
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    /** `false` iken arka plana tıklama, Escape ve kapatma düğmesi kapatmaz. */
+    isDismissable?: boolean;
+    className?: string;
+    testId?: string;
+};
+/** Kip pencere (modal). */
+declare const Modal: ({ isOpen, onClose, title, closeLabel, children, description, footer, icon, tone, size, isDismissable, className, testId, }: Props) => import("react").JSX.Element;
+declare const _default: typeof Modal;
+export default _default;

package/build/components/Modal/index.js

@@ -0,0 +1,92 @@
+"use client";
+import { jsx as o, jsxs as u } from "react/jsx-runtime";
+import { memo as R, useRef as N, useId as g, useEffect as k, useCallback as j } from "react";
+import { XLg as B } from "react-bootstrap-icons";
+import { cx as M } from "../../helpers/class-name.helper.js";
+import { focusFirstMeaningful as w, preventAutoKeyboard as z, pushModal as A, captureFocus as C, isTopModal as K } from "../../helpers/focus.helper.js";
+import { resolveLabel as S } from "../../helpers/label.helper.js";
+import T from "../../hooks/useScrollLock.js";
+import { useUi as U } from "../../theme/context.js";
+import X from "../IconButton/index.js";
+const r = {"modal":"ui-modal-3IDi9","modal--sm":"ui-modal--sm-A7WsS","modal--lg":"ui-modal--lg-z99Em","modal--xl":"ui-modal--xl-g3d6F","modal__panel":"ui-modal__panel--qLSz","modal__header":"ui-modal__header-meWm6","modal__icon":"ui-modal__icon-df2dd","modal__icon--neutral":"ui-modal__icon--neutral-QSL7c","modal__icon--danger":"ui-modal__icon--danger-6V90a","modal__icon--warning":"ui-modal__icon--warning-a--FX","modal__icon--success":"ui-modal__icon--success-YWxZs","modal__icon--info":"ui-modal__icon--info-WRLah","modal__heading":"ui-modal__heading-PwDS8","modal__title":"ui-modal__title-80Sh6","modal__description":"ui-modal__description-fsCHI","modal__close":"ui-modal__close-vFPbw","modal__body":"ui-modal__body-PDF12","modal__footer":"ui-modal__footer-CCCkx"};
+const q = ({
+  isOpen: d,
+  onClose: a,
+  title: L,
+  closeLabel: b,
+  children: f,
+  description: i,
+  footer: p,
+  icon: _,
+  tone: y = "neutral",
+  size: x = "md",
+  isDismissable: t = !0,
+  className: I,
+  testId: $
+}) => {
+  const { labels: s } = U(), l = N(null), c = N(null), h = g(), v = g();
+  k(() => {
+    const e = l.current;
+    if (!e) return;
+    if (!d) {
+      e.open && e.close();
+      return;
+    }
+    const n = C();
+    e.open || e.showModal(), w(e, `.${r.modal__close}`), z(e);
+    const { token: m, pop: F } = A();
+    return c.current = m, () => {
+      F(), c.current = null, n();
+    };
+  }, [d]), T(d), k(() => {
+    const e = l.current;
+    if (!e) return;
+    const n = (m) => {
+      m.preventDefault(), t && (c.current && !K(c.current) || a());
+    };
+    return e.addEventListener("cancel", n), () => e.removeEventListener("cancel", n);
+  }, [a, t]);
+  const E = j(
+    (e) => {
+      t && e.target === l.current && a();
+    },
+    [t, a]
+  );
+  return /* @__PURE__ */ o(
+    "dialog",
+    {
+      ref: l,
+      className: M(r.modal, r[`modal--${x}`], I),
+      "aria-labelledby": h,
+      "aria-describedby": i ? v : void 0,
+      "data-testid": $,
+      onClick: E,
+      children: /* @__PURE__ */ u("div", { className: r.modal__panel, children: [
+        /* @__PURE__ */ u("header", { className: r.modal__header, children: [
+          _ && /* @__PURE__ */ o("span", { className: M(r.modal__icon, r[`modal__icon--${y}`]), children: _ }),
+          /* @__PURE__ */ u("div", { className: r.modal__heading, children: [
+            /* @__PURE__ */ o("h2", { id: h, className: r.modal__title, children: L }),
+            i && /* @__PURE__ */ o("p", { id: v, className: r.modal__description, children: i })
+          ] }),
+          t && /* @__PURE__ */ o(
+            X,
+            {
+              icon: /* @__PURE__ */ o(B, { "aria-hidden": !0 }),
+              label: S("Modal.closeLabel", b, s == null ? void 0 : s.close),
+              variant: "ghost",
+              size: "sm",
+              className: r.modal__close,
+              onClick: a
+            }
+          )
+        ] }),
+        f && /* @__PURE__ */ o("div", { className: r.modal__body, children: f }),
+        p && /* @__PURE__ */ o("footer", { className: r.modal__footer, children: p })
+      ] })
+    }
+  );
+}, D = /* @__PURE__ */ R(q);
+export {
+  D as default
+};
+//# sourceMappingURL=index.js.map

package/build/components/Modal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/components/Modal/index.tsx"],"sourcesContent":["'use client';\n\nimport {\n  memo,\n  type MouseEvent,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useId,\n  useRef,\n} from 'react';\n\nimport { XLg } from 'react-bootstrap-icons';\n\nimport { cx } from '../../helpers/class-name.helper';\nimport {\n  captureFocus,\n  focusFirstMeaningful,\n  isTopModal,\n  preventAutoKeyboard,\n  pushModal,\n} from '../../helpers/focus.helper';\nimport { resolveLabel } from '../../helpers/label.helper';\nimport useScrollLock from '../../hooks/useScrollLock';\nimport { useUi } from '../../theme/context';\nimport IconButton from '../IconButton';\n\nimport styles from './index.module.scss';\n\nexport type ModalTone = 'neutral' | 'danger' | 'warning' | 'success' | 'info';\n\ntype Props = {\n  isOpen: boolean;\n  onClose: () => void;\n  title: string;\n  /** Kapatma düğmesinin erişilebilir adı. */\n  closeLabel?: string;\n  children?: ReactNode;\n  /** Başlığın altındaki bir cümlelik açıklama. */\n  description?: ReactNode;\n  /** Altta duran eylemler. */\n  footer?: ReactNode;\n  /** Başlığın solunda duran ikon madalyonu; `tone` rengini alır. */\n  icon?: ReactNode;\n  /** İkon madalyonunun tonu. */\n  tone?: ModalTone;\n  /** `xl` (≈1040 px) sekmeli, tablolu panolar için; dar ekranda diğerleri gibi tam genişlik. */\n  size?: 'sm' | 'md' | 'lg' | 'xl';\n  /** `false` iken arka plana tıklama, Escape ve kapatma düğmesi kapatmaz. */\n  isDismissable?: boolean;\n  className?: string;\n  testId?: string;\n};\n\n/** Kip pencere (modal). */\nconst Modal = ({\n  isOpen,\n  onClose,\n  title,\n  closeLabel,\n  children,\n  description,\n  footer,\n  icon,\n  tone = 'neutral',\n  size = 'md',\n  isDismissable = true,\n  className,\n  testId,\n}: Props) => {\n  const { labels } = useUi();\n  const dialogRef = useRef<HTMLDialogElement>(null);\n  /* Yigindaki yerimiz: */\n  const tokenRef = useRef<symbol | null>(null);\n  const titleId = useId();\n  const descriptionId = useId();\n\n  /* ACILIS: `showModal()` + odak + yigina katilma. */\n  useEffect(() => {\n    const dialog = dialogRef.current;\n    if (!dialog) return;\n\n    if (!isOpen) {\n      if (dialog.open) dialog.close();\n      return;\n    }\n\n    const restoreFocus = captureFocus();\n    if (!dialog.open) dialog.showModal();\n\n    /*\n     * Odak KAPATMA DUGMESINE degil ilk anlamli ogeye. `showModal()` DOM sirasindaki ilk\n     * odaklanabilir ogeye gidiyor ve o neredeyse her zaman basliktaki…\n     */\n    focusFirstMeaningful(dialog, `.${styles.modal__close}`);\n    /*\n     * Odak bir metin alanina dustuyse geri alinir: telefonda ekran klavyesi kullanici istemeden\n     * aciliyordu (bkz. `helpers/focus.helper`).\n     */\n    preventAutoKeyboard(dialog);\n\n    const { token, pop } = pushModal();\n    tokenRef.current = token;\n\n    return () => {\n      pop();\n      tokenRef.current = null;\n      restoreFocus();\n    };\n  }, [isOpen]);\n\n  /*\n   * Arka plan kaydirmasi kilitlenir. `showModal()` arka plani etkilesime kapatir ama kaydirmayi her\n   * tarayicida engellemiyor: kullanici pencereyi…\n   */\n  useScrollLock(isOpen);\n\n  /*\n   * Escape'i tarayici isliyor ama React durumu bundan haberdar olmuyor; `cancel` olayi yakalanmazsa\n   * pencere kapanip `isOpen` true kaliyor ve bir daha…\n   */\n  useEffect(() => {\n    const dialog = dialogRef.current;\n    if (!dialog) return;\n\n    const handleCancel = (event: Event) => {\n      /*\n       * Varsayilan HER ZAMAN engellenir: kapanis karari React'te veriliyor ve tarayicinin pencereyi\n       * kendi basina kapatmasi durumu `isOpen: true` birakiyordu.\n       */\n      event.preventDefault();\n      if (!isDismissable) return;\n\n      /* Yalnizca EN USTTEKI panel kapanir. */\n      if (tokenRef.current && !isTopModal(tokenRef.current)) return;\n\n      onClose();\n    };\n\n    dialog.addEventListener('cancel', handleCancel);\n    return () => dialog.removeEventListener('cancel', handleCancel);\n  }, [onClose, isDismissable]);\n\n  const handleBackdropClick = useCallback(\n    (event: MouseEvent<HTMLDialogElement>) => {\n      if (!isDismissable) return;\n      // Hedef dialog'un KENDISI ise arka plana tiklanmistir; panel degil.\n      if (event.target === dialogRef.current) onClose();\n    },\n    [isDismissable, onClose],\n  );\n\n  return (\n    <dialog\n      ref={dialogRef}\n      className={cx(styles.modal, styles[`modal--${size}`], className)}\n      aria-labelledby={titleId}\n      aria-describedby={description ? descriptionId : undefined}\n      data-testid={testId}\n      onClick={handleBackdropClick}\n    >\n      <div className={styles.modal__panel}>\n        <header className={styles.modal__header}>\n          {icon && (\n            <span className={cx(styles.modal__icon, styles[`modal__icon--${tone}`])}>{icon}</span>\n          )}\n\n          <div className={styles.modal__heading}>\n            <h2 id={titleId} className={styles.modal__title}>\n              {title}\n            </h2>\n            {description && (\n              <p id={descriptionId} className={styles.modal__description}>\n                {description}\n              </p>\n            )}\n          </div>\n\n          {isDismissable && (\n            <IconButton\n              icon={<XLg aria-hidden />}\n              label={resolveLabel('Modal.closeLabel', closeLabel, labels?.close)}\n              variant=\"ghost\"\n              size=\"sm\"\n              className={styles.modal__close}\n              onClick={onClose}\n            />\n          )}\n        </header>\n\n        {/*\n          Gövde yalnızca içerik VARSA çizilir: onay pencerelerinin çoğunda soru\n          başlıkta ve açıklamada duruyor, gövde boş kalıyor ve boş bir kutu\n          40 px'lik bir boşluk bırakıyordu.\n        */}\n        {children && <div className={styles.modal__body}>{children}</div>}\n\n        {footer && <footer className={styles.modal__footer}>{footer}</footer>}\n      </div>\n    </dialog>\n  );\n};\n\nexport default /*#__PURE__*/ memo(Modal) as typeof Modal;\n"],"names":["Modal","isOpen","onClose","title","closeLabel","children","description","footer","icon","tone","size","isDismissable","className","testId","labels","useUi","dialogRef","useRef","tokenRef","titleId","useId","descriptionId","useEffect","dialog","restoreFocus","captureFocus","focusFirstMeaningful","styles","preventAutoKeyboard","token","pop","pushModal","useScrollLock","handleCancel","event","isTopModal","handleBackdropClick","useCallback","jsx","cx","jsxs","IconButton","XLg","resolveLabel","Modal$1"],"mappings":"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"}