@handijit/ui 0.0.0-stage → 2.0.0

package/build/enums/ui-variant.enum.js

@@ -0,0 +1,5 @@
+var A = /* @__PURE__ */ ((N) => (N.PRIMARY = "PRIMARY", N.ACCENT = "ACCENT", N.SECONDARY = "SECONDARY", N.OUTLINE = "OUTLINE", N.SOFT = "SOFT", N.GHOST = "GHOST", N.DANGER = "DANGER", N.ON_BAND = "ON_BAND", N))(A || {});
+export {
+  A as default
+};
+//# sourceMappingURL=ui-variant.enum.js.map

package/build/enums/ui-variant.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-variant.enum.js","sources":["../../src/enums/ui-variant.enum.ts"],"sourcesContent":["/** Button variants. */\nenum UIVariant {\n  /** The one expected action of the screen: cobalt fill. One per screen. */\n  PRIMARY = 'PRIMARY',\n  /** The conversion action (download, try, subscribe): coral fill — and only that. */\n  ACCENT = 'ACCENT',\n  /** Neutral secondary action: grey border, body text (\"Cancel\"). */\n  SECONDARY = 'SECONDARY',\n  /** Cobalt frame — an encouraged navigation that is not the primary action (\"See all\"). */\n  OUTLINE = 'OUTLINE',\n  /** Neutral fill; a secondary action inside a card. */\n  SOFT = 'SOFT',\n  /** No surface: toolbar and inline secondary actions, in the link colour. */\n  GHOST = 'GHOST',\n  /** Destructive action: a delete confirmation. */\n  DANGER = 'DANGER',\n  /** An action on the brand band (deep cobalt in both themes). */\n  ON_BAND = 'ON_BAND',\n}\n\nexport default UIVariant;\n"],"names":["UIVariant"],"mappings":"AACA,IAAKA,sBAAAA,OAEHA,EAAA,UAAU,WAEVA,EAAA,SAAS,UAETA,EAAA,YAAY,aAEZA,EAAA,UAAU,WAEVA,EAAA,OAAO,QAEPA,EAAA,QAAQ,SAERA,EAAA,SAAS,UAETA,EAAA,UAAU,WAhBPA,IAAAA,KAAA,CAAA,CAAA;"}

package/build/helpers/class-name.helper.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=(...o)=>{let e="";for(const t of o)t&&(e=e===""?t:`${e} ${t}`);return e};exports.cx=r;
+//# sourceMappingURL=class-name.helper.cjs.map

package/build/helpers/class-name.helper.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-name.helper.cjs","sources":["../../src/helpers/class-name.helper.ts"],"sourcesContent":["import { ClassValue } from '@/types/common-element-props.type';\n\n/** Sınıf adı birleştirici. */\nexport const cx = (...values: ClassValue[]): string => {\n  let result = '';\n\n  for (const value of values) {\n    if (!value) continue;\n    result = result === '' ? value : `${result} ${value}`;\n  }\n\n  return result;\n};\n"],"names":["cx","values","result","value"],"mappings":"gFAGO,MAAMA,EAAK,IAAIC,IAAiC,CACrD,IAAIC,EAAS,GAEb,UAAWC,KAASF,EACbE,IACLD,EAASA,IAAW,GAAKC,EAAQ,GAAGD,CAAM,IAAIC,CAAK,IAGrD,OAAOD,CACT"}

package/build/helpers/class-name.helper.d.ts

@@ -0,0 +1,3 @@
+import { ClassValue } from '../types/common-element-props.type';
+/** Sınıf adı birleştirici. */
+export declare const cx: (...values: ClassValue[]) => string;

package/build/helpers/class-name.helper.js

@@ -0,0 +1,10 @@
+const n = (...o) => {
+  let t = "";
+  for (const e of o)
+    e && (t = t === "" ? e : `${t} ${e}`);
+  return t;
+};
+export {
+  n as cx
+};
+//# sourceMappingURL=class-name.helper.js.map

package/build/helpers/class-name.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-name.helper.js","sources":["../../src/helpers/class-name.helper.ts"],"sourcesContent":["import { ClassValue } from '@/types/common-element-props.type';\n\n/** Sınıf adı birleştirici. */\nexport const cx = (...values: ClassValue[]): string => {\n  let result = '';\n\n  for (const value of values) {\n    if (!value) continue;\n    result = result === '' ? value : `${result} ${value}`;\n  }\n\n  return result;\n};\n"],"names":["cx","values","result","value"],"mappings":"AAGO,MAAMA,IAAK,IAAIC,MAAiC;AACrD,MAAIC,IAAS;AAEb,aAAWC,KAASF;AAClB,IAAKE,MACLD,IAASA,MAAW,KAAKC,IAAQ,GAAGD,CAAM,IAAIC,CAAK;AAGrD,SAAOD;AACT;"}

package/build/helpers/component.helper.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=(e,t)=>Object.assign(e,{displayName:t});exports.named=n;
+//# sourceMappingURL=component.helper.cjs.map

package/build/helpers/component.helper.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.helper.cjs","sources":["../../src/helpers/component.helper.ts"],"sourcesContent":["/**\n * DevTools adı — modül düzeyinde YAN ETKİ bırakmadan.\n *\n * ⚠ `X.displayName = 'X'` KULLANILMAZ: modül düzeyindeki özellik ataması\n * bundler için yan etkidir ve hedefinin tüm bağımlılık zincirini ayakta tutar.\n * Ölçüldü: yalnızca `Badge` import eden uygulama 20,7 kB indiriyordu (paketin\n * tamamı 21,8 kB). Atama çağrıya dönüşünce `#__PURE__` işaretlenebiliyor →\n * `Badge` 2,71 kB. Nöbetçi `.size-limit.json`.\n *\n * @example\n * export default memo(named(Button, 'Button')) as typeof Button;\n */\nexport const named = <TComponent extends object>(\n  component: TComponent,\n  displayName: string,\n): TComponent => Object.assign(component, { displayName });\n"],"names":["named","component","displayName"],"mappings":"gFAYO,MAAMA,EAAQ,CACnBC,EACAC,IACe,OAAO,OAAOD,EAAW,CAAE,YAAAC,CAAA,CAAa"}

package/build/helpers/component.helper.d.ts

@@ -0,0 +1,13 @@
+/**
+ * DevTools adı — modül düzeyinde YAN ETKİ bırakmadan.
+ *
+ * ⚠ `X.displayName = 'X'` KULLANILMAZ: modül düzeyindeki özellik ataması
+ * bundler için yan etkidir ve hedefinin tüm bağımlılık zincirini ayakta tutar.
+ * Ölçüldü: yalnızca `Badge` import eden uygulama 20,7 kB indiriyordu (paketin
+ * tamamı 21,8 kB). Atama çağrıya dönüşünce `#__PURE__` işaretlenebiliyor →
+ * `Badge` 2,71 kB. Nöbetçi `.size-limit.json`.
+ *
+ * @example
+ * export default memo(named(Button, 'Button')) as typeof Button;
+ */
+export declare const named: <TComponent extends object>(component: TComponent, displayName: string) => TComponent;

package/build/helpers/component.helper.js

@@ -0,0 +1,5 @@
+const s = (e, n) => Object.assign(e, { displayName: n });
+export {
+  s as named
+};
+//# sourceMappingURL=component.helper.js.map

package/build/helpers/component.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.helper.js","sources":["../../src/helpers/component.helper.ts"],"sourcesContent":["/**\n * DevTools adı — modül düzeyinde YAN ETKİ bırakmadan.\n *\n * ⚠ `X.displayName = 'X'` KULLANILMAZ: modül düzeyindeki özellik ataması\n * bundler için yan etkidir ve hedefinin tüm bağımlılık zincirini ayakta tutar.\n * Ölçüldü: yalnızca `Badge` import eden uygulama 20,7 kB indiriyordu (paketin\n * tamamı 21,8 kB). Atama çağrıya dönüşünce `#__PURE__` işaretlenebiliyor →\n * `Badge` 2,71 kB. Nöbetçi `.size-limit.json`.\n *\n * @example\n * export default memo(named(Button, 'Button')) as typeof Button;\n */\nexport const named = <TComponent extends object>(\n  component: TComponent,\n  displayName: string,\n): TComponent => Object.assign(component, { displayName });\n"],"names":["named","component","displayName"],"mappings":"AAYO,MAAMA,IAAQ,CACnBC,GACAC,MACe,OAAO,OAAOD,GAAW,EAAE,aAAAC,EAAA,CAAa;"}

package/build/helpers/focus.helper.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=new Set(["button","checkbox","color","file","hidden","image","radio","range","reset","submit"]),s=e=>{if(!(e instanceof HTMLElement))return!1;if(e.isContentEditable)return!0;const t=e.getAttribute("contenteditable");if(t===""||t==="true"||t==="plaintext-only")return!0;const n=e.tagName;return n==="TEXTAREA"?!0:n!=="INPUT"?!1:!a.has(e.type)},i=e=>{const t=e.ownerDocument.activeElement;!e.contains(t)||!s(t)||(t.blur(),e.tabIndex=-1,e.focus({preventScroll:!0}))},l=()=>{const e=typeof document>"u"?null:document.activeElement;return()=>{e instanceof HTMLElement&&e.isConnected&&e.focus({preventScroll:!0})}},d=["a[href]","button:not(:disabled)","input:not(:disabled)","select:not(:disabled)","textarea:not(:disabled)",'[tabindex]:not([tabindex="-1"])'].map(e=>`${e}:not([inert]):not([aria-hidden="true"])`).join(", "),f=(e,t="[data-ui-close]")=>{const n=e.querySelector("[data-ui-autofocus]");if(n){n.focus({preventScroll:!0});return}const r=[...e.querySelectorAll(d)],u=r.find(c=>!c.matches(t))??r[0];if(u){u.focus({preventScroll:!0});return}e.tabIndex=-1,e.focus({preventScroll:!0})},o=[],p=()=>{const e=Symbol("ui-modal");return o.push(e),{token:e,pop:()=>{const t=o.indexOf(e);t>=0&&o.splice(t,1)}}},b=e=>o.at(-1)===e,S=()=>o.length>0;exports.captureFocus=l;exports.focusFirstMeaningful=f;exports.hasOpenSurface=S;exports.isKeyboardOpeningElement=s;exports.isTopModal=b;exports.preventAutoKeyboard=i;exports.pushModal=p;
+//# sourceMappingURL=focus.helper.cjs.map

package/build/helpers/focus.helper.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.helper.cjs","sources":["../../src/helpers/focus.helper.ts"],"sourcesContent":["/** Kipsel panel açılırken ekran klavyesinin kendiliğinden açılmasını engeller. */\n\n/** Odaklanınca ekran klavyesi AÇMAYAN giriş türleri. */\nconst NON_TEXT_INPUT_TYPES = new Set([\n  'button',\n  'checkbox',\n  'color',\n  'file',\n  'hidden',\n  'image',\n  'radio',\n  'range',\n  'reset',\n  'submit',\n]);\n\n/** Odaklanınca mobilde ekran klavyesini açacak bir öğe mi? */\nexport const isKeyboardOpeningElement = (element: Element | null): boolean => {\n  if (!(element instanceof HTMLElement)) return false;\n\n  /*\n   * `isContentEditable` mirasi da kapsar (duzenlenebilir bolgenin ICINDEKI oge), ama jsdom onu\n   * uygulamiyor ve her zaman false donuyor\n   */\n  if (element.isContentEditable) return true;\n  const editable = element.getAttribute('contenteditable');\n  if (editable === '' || editable === 'true' || editable === 'plaintext-only') return true;\n\n  const tagName = element.tagName;\n  if (tagName === 'TEXTAREA') return true;\n  if (tagName !== 'INPUT') return false;\n\n  return !NON_TEXT_INPUT_TYPES.has((element as HTMLInputElement).type);\n};\n\n/** `showModal()` ÇAĞRILDIKTAN SONRA çağrılır. */\nexport const preventAutoKeyboard = (dialog: HTMLDialogElement): void => {\n  const active = dialog.ownerDocument.activeElement;\n  if (!dialog.contains(active) || !isKeyboardOpeningElement(active)) return;\n\n  (active as HTMLElement).blur();\n  // `<dialog>` varsayılan olarak odaklanabilir değil; odağı alabilmesi için sıra dışı bırakılır\n  // (Tab ile gezinmede görünmez, `focus()` ile alınır).\n  dialog.tabIndex = -1;\n  dialog.focus({ preventScroll: true });\n};\n\n/**\n * ODAK GERİ DÖNÜŞÜ.\n * @returns Odağı geri veren fonksiyon.\n */\nexport const captureFocus = (): (() => void) => {\n  const previous = typeof document === 'undefined' ? null : document.activeElement;\n\n  return () => {\n    if (!(previous instanceof HTMLElement)) return;\n\n    /*\n     * Oge hala BELGEDE mi: acan dugme, panel kapanirken DOM'dan kalkmis olabilir (bir satiri silen\n     * onay penceresi, satirla birlikte dugmeyi de goturuyor).\n     */\n    if (!previous.isConnected) return;\n\n    /*\n     * `preventScroll` — odaklanan oge gorunum alaninin disindaysa tarayici sayfayi oraya kaydiriyor\n     * ve kullanici kapattigi pencerenin yerine bambaska bir…\n     */\n    previous.focus({ preventScroll: true });\n  };\n};\n\n/** Odaklanabilir öğelerin seçicisi — `inert` ve `disabled` olanlar hariç. */\nconst FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'button:not(:disabled)',\n  'input:not(:disabled)',\n  'select:not(:disabled)',\n  'textarea:not(:disabled)',\n  '[tabindex]:not([tabindex=\"-1\"])',\n]\n  .map(selector => `${selector}:not([inert]):not([aria-hidden=\"true\"])`)\n  .join(', ');\n\n/**\n * Panelin İLK ANLAMLI öğesine odaklanır.\n * @param container Odak aranacak kök.\n * @param skipSelector Atlanacak öğe (varsayılan: kapatma düğmesi).\n */\nexport const focusFirstMeaningful = (\n  container: HTMLElement,\n  skipSelector = '[data-ui-close]',\n): void => {\n  const explicit = container.querySelector<HTMLElement>('[data-ui-autofocus]');\n  if (explicit) {\n    explicit.focus({ preventScroll: true });\n    return;\n  }\n\n  const candidates = [...container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)];\n  const target = candidates.find(element => !element.matches(skipSelector)) ?? candidates[0];\n\n  if (target) {\n    target.focus({ preventScroll: true });\n    return;\n  }\n\n  container.tabIndex = -1;\n  container.focus({ preventScroll: true });\n};\n\n/**\n * KİPSEL YIĞIN — üst üste binen paneller. Sahiplik LIFO: en son açılan yüzey tuşu tüketir.\n * ⚠ Yığın yalnızca `<dialog>` tabanlı kipsel yüzeyleri DEĞİL, `Escape` ile kapanan HER yüzeyi taşır\n * (`Popover`, `Toast`, `Tooltip`).\n */\nconst modalStack: symbol[] = [];\n\n/** Yığına katılır; dönen fonksiyon çıkarır. */\nexport const pushModal = (): { token: symbol; pop: () => void } => {\n  const token = Symbol('ui-modal');\n  modalStack.push(token);\n\n  return {\n    token,\n    pop: () => {\n      const index = modalStack.indexOf(token);\n      if (index >= 0) modalStack.splice(index, 1);\n    },\n  };\n};\n\n/** Verilen panel yığının EN ÜSTÜNDE mi. */\nexport const isTopModal = (token: symbol): boolean => modalStack.at(-1) === token;\n\n/**\n * `Escape`i tüketecek AÇIK bir yüzey var mı — kipsel pencere, açılır panel, bildirim.\n * ⚠ Sayfa düzeyinde `Escape` dinleyen her kod (sohbetin \"akışı durdur\" kısayolu gibi) İKİSİNİ BİRDEN\n * sorar: `event.defaultPrevented || hasOpenSurface()`. Sormayan bir dinleyici, kullanıcı yalnızca bir\n * yüzeyi kapatmak isterken arkadaki işi de iptal ediyordu.\n * - `Popover`, `Tooltip` ve `Toast` tuşu belge düzeyindeki kendi dinleyicilerinde tüketir, işaretler\n *   (`preventDefault`) ve AYNI tuş vuruşunda yığından düşer: gerçek tarayıcıda React ayrık olayın\n *   güncellemesini dinleyiciler arasında boşaltır. Yüzeyin dinleyicisinden SONRA koşan kod (pencerede\n *   ya da belgede sonradan eklenmiş) burada `false` görür; ona kalan kanıt `defaultPrevented`.\n *   Ölçüldü (2026-10-27): yardım `Popover`ını kapatan `Escape` bir grafik seçimini de siliyordu.\n *   jsdom bunu göremez: `fireEvent` betikten gönderilir, dinleyiciler arasında mikro görev\n *   boşaltılmaz.\n * - Yüzeyin dinleyicisinden ÖNCE koşan kod işareti göremez ama yığın henüz düşmemiştir: `true`.\n * - `<dialog>` tabanlı kipsel yüzeyler (`Modal`, `Drawer`, `BottomSheet`, `CommandPalette`) tuş olayı\n *   bittikten sonra `cancel` ile kapanır: tuş boyunca burada `true`.\n */\nexport const hasOpenSurface = (): boolean => modalStack.length > 0;\n\n/** Yalnızca test içindir: modül düzeyindeki yığın testler arasında sızmamalı. */\nexport const resetModalStack = (): void => {\n  modalStack.length = 0;\n};\n"],"names":["NON_TEXT_INPUT_TYPES","isKeyboardOpeningElement","element","editable","tagName","preventAutoKeyboard","dialog","active","captureFocus","previous","FOCUSABLE_SELECTOR","selector","focusFirstMeaningful","container","skipSelector","explicit","candidates","target","modalStack","pushModal","token","index","isTopModal","hasOpenSurface"],"mappings":"gFAGA,MAAMA,MAA2B,IAAI,CACnC,SACA,WACA,QACA,OACA,SACA,QACA,QACA,QACA,QACA,QACF,CAAC,EAGYC,EAA4BC,GAAqC,CAC5E,GAAI,EAAEA,aAAmB,aAAc,MAAO,GAM9C,GAAIA,EAAQ,kBAAmB,MAAO,GACtC,MAAMC,EAAWD,EAAQ,aAAa,iBAAiB,EACvD,GAAIC,IAAa,IAAMA,IAAa,QAAUA,IAAa,iBAAkB,MAAO,GAEpF,MAAMC,EAAUF,EAAQ,QACxB,OAAIE,IAAY,WAAmB,GAC/BA,IAAY,QAAgB,GAEzB,CAACJ,EAAqB,IAAKE,EAA6B,IAAI,CACrE,EAGaG,EAAuBC,GAAoC,CACtE,MAAMC,EAASD,EAAO,cAAc,cAChC,CAACA,EAAO,SAASC,CAAM,GAAK,CAACN,EAAyBM,CAAM,IAE/DA,EAAuB,KAAA,EAGxBD,EAAO,SAAW,GAClBA,EAAO,MAAM,CAAE,cAAe,EAAA,CAAM,EACtC,EAMaE,EAAe,IAAoB,CAC9C,MAAMC,EAAW,OAAO,SAAa,IAAc,KAAO,SAAS,cAEnE,MAAO,IAAM,CACLA,aAAoB,aAMrBA,EAAS,aAMdA,EAAS,MAAM,CAAE,cAAe,EAAA,CAAM,CACxC,CACF,EAGMC,EAAqB,CACzB,UACA,wBACA,uBACA,wBACA,0BACA,iCACF,EACG,IAAIC,GAAY,GAAGA,CAAQ,yCAAyC,EACpE,KAAK,IAAI,EAOCC,EAAuB,CAClCC,EACAC,EAAe,oBACN,CACT,MAAMC,EAAWF,EAAU,cAA2B,qBAAqB,EAC3E,GAAIE,EAAU,CACZA,EAAS,MAAM,CAAE,cAAe,EAAA,CAAM,EACtC,MACF,CAEA,MAAMC,EAAa,CAAC,GAAGH,EAAU,iBAA8BH,CAAkB,CAAC,EAC5EO,EAASD,EAAW,KAAKd,GAAW,CAACA,EAAQ,QAAQY,CAAY,CAAC,GAAKE,EAAW,CAAC,EAEzF,GAAIC,EAAQ,CACVA,EAAO,MAAM,CAAE,cAAe,EAAA,CAAM,EACpC,MACF,CAEAJ,EAAU,SAAW,GACrBA,EAAU,MAAM,CAAE,cAAe,EAAA,CAAM,CACzC,EAOMK,EAAuB,CAAA,EAGhBC,EAAY,IAA0C,CACjE,MAAMC,EAAQ,OAAO,UAAU,EAC/B,OAAAF,EAAW,KAAKE,CAAK,EAEd,CACL,MAAAA,EACA,IAAK,IAAM,CACT,MAAMC,EAAQH,EAAW,QAAQE,CAAK,EAClCC,GAAS,GAAGH,EAAW,OAAOG,EAAO,CAAC,CAC5C,CAAA,CAEJ,EAGaC,EAAcF,GAA2BF,EAAW,GAAG,EAAE,IAAME,EAkB/DG,EAAiB,IAAeL,EAAW,OAAS"}

package/build/helpers/focus.helper.d.ts

@@ -0,0 +1,42 @@
+/** Kipsel panel açılırken ekran klavyesinin kendiliğinden açılmasını engeller. */
+/** Odaklanınca mobilde ekran klavyesini açacak bir öğe mi? */
+export declare const isKeyboardOpeningElement: (element: Element | null) => boolean;
+/** `showModal()` ÇAĞRILDIKTAN SONRA çağrılır. */
+export declare const preventAutoKeyboard: (dialog: HTMLDialogElement) => void;
+/**
+ * ODAK GERİ DÖNÜŞÜ.
+ * @returns Odağı geri veren fonksiyon.
+ */
+export declare const captureFocus: () => (() => void);
+/**
+ * Panelin İLK ANLAMLI öğesine odaklanır.
+ * @param container Odak aranacak kök.
+ * @param skipSelector Atlanacak öğe (varsayılan: kapatma düğmesi).
+ */
+export declare const focusFirstMeaningful: (container: HTMLElement, skipSelector?: string) => void;
+/** Yığına katılır; dönen fonksiyon çıkarır. */
+export declare const pushModal: () => {
+    token: symbol;
+    pop: () => void;
+};
+/** Verilen panel yığının EN ÜSTÜNDE mi. */
+export declare const isTopModal: (token: symbol) => boolean;
+/**
+ * `Escape`i tüketecek AÇIK bir yüzey var mı — kipsel pencere, açılır panel, bildirim.
+ * ⚠ Sayfa düzeyinde `Escape` dinleyen her kod (sohbetin "akışı durdur" kısayolu gibi) İKİSİNİ BİRDEN
+ * sorar: `event.defaultPrevented || hasOpenSurface()`. Sormayan bir dinleyici, kullanıcı yalnızca bir
+ * yüzeyi kapatmak isterken arkadaki işi de iptal ediyordu.
+ * - `Popover`, `Tooltip` ve `Toast` tuşu belge düzeyindeki kendi dinleyicilerinde tüketir, işaretler
+ *   (`preventDefault`) ve AYNI tuş vuruşunda yığından düşer: gerçek tarayıcıda React ayrık olayın
+ *   güncellemesini dinleyiciler arasında boşaltır. Yüzeyin dinleyicisinden SONRA koşan kod (pencerede
+ *   ya da belgede sonradan eklenmiş) burada `false` görür; ona kalan kanıt `defaultPrevented`.
+ *   Ölçüldü (2026-10-27): yardım `Popover`ını kapatan `Escape` bir grafik seçimini de siliyordu.
+ *   jsdom bunu göremez: `fireEvent` betikten gönderilir, dinleyiciler arasında mikro görev
+ *   boşaltılmaz.
+ * - Yüzeyin dinleyicisinden ÖNCE koşan kod işareti göremez ama yığın henüz düşmemiştir: `true`.
+ * - `<dialog>` tabanlı kipsel yüzeyler (`Modal`, `Drawer`, `BottomSheet`, `CommandPalette`) tuş olayı
+ *   bittikten sonra `cancel` ile kapanır: tuş boyunca burada `true`.
+ */
+export declare const hasOpenSurface: () => boolean;
+/** Yalnızca test içindir: modül düzeyindeki yığın testler arasında sızmamalı. */
+export declare const resetModalStack: () => void;

package/build/helpers/focus.helper.js

@@ -0,0 +1,65 @@
+const s = /* @__PURE__ */ new Set([
+  "button",
+  "checkbox",
+  "color",
+  "file",
+  "hidden",
+  "image",
+  "radio",
+  "range",
+  "reset",
+  "submit"
+]), i = (t) => {
+  if (!(t instanceof HTMLElement)) return !1;
+  if (t.isContentEditable) return !0;
+  const e = t.getAttribute("contenteditable");
+  if (e === "" || e === "true" || e === "plaintext-only") return !0;
+  const n = t.tagName;
+  return n === "TEXTAREA" ? !0 : n !== "INPUT" ? !1 : !s.has(t.type);
+}, l = (t) => {
+  const e = t.ownerDocument.activeElement;
+  !t.contains(e) || !i(e) || (e.blur(), t.tabIndex = -1, t.focus({ preventScroll: !0 }));
+}, d = () => {
+  const t = typeof document > "u" ? null : document.activeElement;
+  return () => {
+    t instanceof HTMLElement && t.isConnected && t.focus({ preventScroll: !0 });
+  };
+}, a = [
+  "a[href]",
+  "button:not(:disabled)",
+  "input:not(:disabled)",
+  "select:not(:disabled)",
+  "textarea:not(:disabled)",
+  '[tabindex]:not([tabindex="-1"])'
+].map((t) => `${t}:not([inert]):not([aria-hidden="true"])`).join(", "), f = (t, e = "[data-ui-close]") => {
+  const n = t.querySelector("[data-ui-autofocus]");
+  if (n) {
+    n.focus({ preventScroll: !0 });
+    return;
+  }
+  const r = [...t.querySelectorAll(a)], u = r.find((c) => !c.matches(e)) ?? r[0];
+  if (u) {
+    u.focus({ preventScroll: !0 });
+    return;
+  }
+  t.tabIndex = -1, t.focus({ preventScroll: !0 });
+}, o = [], p = () => {
+  const t = Symbol("ui-modal");
+  return o.push(t), {
+    token: t,
+    pop: () => {
+      const e = o.indexOf(t);
+      e >= 0 && o.splice(e, 1);
+    }
+  };
+}, b = (t) => o.at(-1) === t, S = () => o.length > 0;
+export {
+  d as captureFocus,
+  f as focusFirstMeaningful,
+  S as hasOpenSurface,
+  i as isKeyboardOpeningElement,
+  b as isTopModal,
+  l as preventAutoKeyboard,
+  p as pushModal
+};
+//# sourceMappingURL=focus.helper.js.map

package/build/helpers/focus.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.helper.js","sources":["../../src/helpers/focus.helper.ts"],"sourcesContent":["/** Kipsel panel açılırken ekran klavyesinin kendiliğinden açılmasını engeller. */\n\n/** Odaklanınca ekran klavyesi AÇMAYAN giriş türleri. */\nconst NON_TEXT_INPUT_TYPES = new Set([\n  'button',\n  'checkbox',\n  'color',\n  'file',\n  'hidden',\n  'image',\n  'radio',\n  'range',\n  'reset',\n  'submit',\n]);\n\n/** Odaklanınca mobilde ekran klavyesini açacak bir öğe mi? */\nexport const isKeyboardOpeningElement = (element: Element | null): boolean => {\n  if (!(element instanceof HTMLElement)) return false;\n\n  /*\n   * `isContentEditable` mirasi da kapsar (duzenlenebilir bolgenin ICINDEKI oge), ama jsdom onu\n   * uygulamiyor ve her zaman false donuyor\n   */\n  if (element.isContentEditable) return true;\n  const editable = element.getAttribute('contenteditable');\n  if (editable === '' || editable === 'true' || editable === 'plaintext-only') return true;\n\n  const tagName = element.tagName;\n  if (tagName === 'TEXTAREA') return true;\n  if (tagName !== 'INPUT') return false;\n\n  return !NON_TEXT_INPUT_TYPES.has((element as HTMLInputElement).type);\n};\n\n/** `showModal()` ÇAĞRILDIKTAN SONRA çağrılır. */\nexport const preventAutoKeyboard = (dialog: HTMLDialogElement): void => {\n  const active = dialog.ownerDocument.activeElement;\n  if (!dialog.contains(active) || !isKeyboardOpeningElement(active)) return;\n\n  (active as HTMLElement).blur();\n  // `<dialog>` varsayılan olarak odaklanabilir değil; odağı alabilmesi için sıra dışı bırakılır\n  // (Tab ile gezinmede görünmez, `focus()` ile alınır).\n  dialog.tabIndex = -1;\n  dialog.focus({ preventScroll: true });\n};\n\n/**\n * ODAK GERİ DÖNÜŞÜ.\n * @returns Odağı geri veren fonksiyon.\n */\nexport const captureFocus = (): (() => void) => {\n  const previous = typeof document === 'undefined' ? null : document.activeElement;\n\n  return () => {\n    if (!(previous instanceof HTMLElement)) return;\n\n    /*\n     * Oge hala BELGEDE mi: acan dugme, panel kapanirken DOM'dan kalkmis olabilir (bir satiri silen\n     * onay penceresi, satirla birlikte dugmeyi de goturuyor).\n     */\n    if (!previous.isConnected) return;\n\n    /*\n     * `preventScroll` — odaklanan oge gorunum alaninin disindaysa tarayici sayfayi oraya kaydiriyor\n     * ve kullanici kapattigi pencerenin yerine bambaska bir…\n     */\n    previous.focus({ preventScroll: true });\n  };\n};\n\n/** Odaklanabilir öğelerin seçicisi — `inert` ve `disabled` olanlar hariç. */\nconst FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'button:not(:disabled)',\n  'input:not(:disabled)',\n  'select:not(:disabled)',\n  'textarea:not(:disabled)',\n  '[tabindex]:not([tabindex=\"-1\"])',\n]\n  .map(selector => `${selector}:not([inert]):not([aria-hidden=\"true\"])`)\n  .join(', ');\n\n/**\n * Panelin İLK ANLAMLI öğesine odaklanır.\n * @param container Odak aranacak kök.\n * @param skipSelector Atlanacak öğe (varsayılan: kapatma düğmesi).\n */\nexport const focusFirstMeaningful = (\n  container: HTMLElement,\n  skipSelector = '[data-ui-close]',\n): void => {\n  const explicit = container.querySelector<HTMLElement>('[data-ui-autofocus]');\n  if (explicit) {\n    explicit.focus({ preventScroll: true });\n    return;\n  }\n\n  const candidates = [...container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)];\n  const target = candidates.find(element => !element.matches(skipSelector)) ?? candidates[0];\n\n  if (target) {\n    target.focus({ preventScroll: true });\n    return;\n  }\n\n  container.tabIndex = -1;\n  container.focus({ preventScroll: true });\n};\n\n/**\n * KİPSEL YIĞIN — üst üste binen paneller. Sahiplik LIFO: en son açılan yüzey tuşu tüketir.\n * ⚠ Yığın yalnızca `<dialog>` tabanlı kipsel yüzeyleri DEĞİL, `Escape` ile kapanan HER yüzeyi taşır\n * (`Popover`, `Toast`, `Tooltip`).\n */\nconst modalStack: symbol[] = [];\n\n/** Yığına katılır; dönen fonksiyon çıkarır. */\nexport const pushModal = (): { token: symbol; pop: () => void } => {\n  const token = Symbol('ui-modal');\n  modalStack.push(token);\n\n  return {\n    token,\n    pop: () => {\n      const index = modalStack.indexOf(token);\n      if (index >= 0) modalStack.splice(index, 1);\n    },\n  };\n};\n\n/** Verilen panel yığının EN ÜSTÜNDE mi. */\nexport const isTopModal = (token: symbol): boolean => modalStack.at(-1) === token;\n\n/**\n * `Escape`i tüketecek AÇIK bir yüzey var mı — kipsel pencere, açılır panel, bildirim.\n * ⚠ Sayfa düzeyinde `Escape` dinleyen her kod (sohbetin \"akışı durdur\" kısayolu gibi) İKİSİNİ BİRDEN\n * sorar: `event.defaultPrevented || hasOpenSurface()`. Sormayan bir dinleyici, kullanıcı yalnızca bir\n * yüzeyi kapatmak isterken arkadaki işi de iptal ediyordu.\n * - `Popover`, `Tooltip` ve `Toast` tuşu belge düzeyindeki kendi dinleyicilerinde tüketir, işaretler\n *   (`preventDefault`) ve AYNI tuş vuruşunda yığından düşer: gerçek tarayıcıda React ayrık olayın\n *   güncellemesini dinleyiciler arasında boşaltır. Yüzeyin dinleyicisinden SONRA koşan kod (pencerede\n *   ya da belgede sonradan eklenmiş) burada `false` görür; ona kalan kanıt `defaultPrevented`.\n *   Ölçüldü (2026-10-27): yardım `Popover`ını kapatan `Escape` bir grafik seçimini de siliyordu.\n *   jsdom bunu göremez: `fireEvent` betikten gönderilir, dinleyiciler arasında mikro görev\n *   boşaltılmaz.\n * - Yüzeyin dinleyicisinden ÖNCE koşan kod işareti göremez ama yığın henüz düşmemiştir: `true`.\n * - `<dialog>` tabanlı kipsel yüzeyler (`Modal`, `Drawer`, `BottomSheet`, `CommandPalette`) tuş olayı\n *   bittikten sonra `cancel` ile kapanır: tuş boyunca burada `true`.\n */\nexport const hasOpenSurface = (): boolean => modalStack.length > 0;\n\n/** Yalnızca test içindir: modül düzeyindeki yığın testler arasında sızmamalı. */\nexport const resetModalStack = (): void => {\n  modalStack.length = 0;\n};\n"],"names":["NON_TEXT_INPUT_TYPES","isKeyboardOpeningElement","element","editable","tagName","preventAutoKeyboard","dialog","active","captureFocus","previous","FOCUSABLE_SELECTOR","selector","focusFirstMeaningful","container","skipSelector","explicit","candidates","target","modalStack","pushModal","token","index","isTopModal","hasOpenSurface"],"mappings":"AAGA,MAAMA,wBAA2B,IAAI;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC,GAGYC,IAA2B,CAACC,MAAqC;AAC5E,MAAI,EAAEA,aAAmB,aAAc,QAAO;AAM9C,MAAIA,EAAQ,kBAAmB,QAAO;AACtC,QAAMC,IAAWD,EAAQ,aAAa,iBAAiB;AACvD,MAAIC,MAAa,MAAMA,MAAa,UAAUA,MAAa,iBAAkB,QAAO;AAEpF,QAAMC,IAAUF,EAAQ;AACxB,SAAIE,MAAY,aAAmB,KAC/BA,MAAY,UAAgB,KAEzB,CAACJ,EAAqB,IAAKE,EAA6B,IAAI;AACrE,GAGaG,IAAsB,CAACC,MAAoC;AACtE,QAAMC,IAASD,EAAO,cAAc;AACpC,EAAI,CAACA,EAAO,SAASC,CAAM,KAAK,CAACN,EAAyBM,CAAM,MAE/DA,EAAuB,KAAA,GAGxBD,EAAO,WAAW,IAClBA,EAAO,MAAM,EAAE,eAAe,GAAA,CAAM;AACtC,GAMaE,IAAe,MAAoB;AAC9C,QAAMC,IAAW,OAAO,WAAa,MAAc,OAAO,SAAS;AAEnE,SAAO,MAAM;AACX,IAAMA,aAAoB,eAMrBA,EAAS,eAMdA,EAAS,MAAM,EAAE,eAAe,GAAA,CAAM;AAAA,EACxC;AACF,GAGMC,IAAqB;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EACG,IAAI,CAAAC,MAAY,GAAGA,CAAQ,yCAAyC,EACpE,KAAK,IAAI,GAOCC,IAAuB,CAClCC,GACAC,IAAe,sBACN;AACT,QAAMC,IAAWF,EAAU,cAA2B,qBAAqB;AAC3E,MAAIE,GAAU;AACZ,IAAAA,EAAS,MAAM,EAAE,eAAe,GAAA,CAAM;AACtC;AAAA,EACF;AAEA,QAAMC,IAAa,CAAC,GAAGH,EAAU,iBAA8BH,CAAkB,CAAC,GAC5EO,IAASD,EAAW,KAAK,CAAAd,MAAW,CAACA,EAAQ,QAAQY,CAAY,CAAC,KAAKE,EAAW,CAAC;AAEzF,MAAIC,GAAQ;AACV,IAAAA,EAAO,MAAM,EAAE,eAAe,GAAA,CAAM;AACpC;AAAA,EACF;AAEA,EAAAJ,EAAU,WAAW,IACrBA,EAAU,MAAM,EAAE,eAAe,GAAA,CAAM;AACzC,GAOMK,IAAuB,CAAA,GAGhBC,IAAY,MAA0C;AACjE,QAAMC,IAAQ,OAAO,UAAU;AAC/B,SAAAF,EAAW,KAAKE,CAAK,GAEd;AAAA,IACL,OAAAA;AAAA,IACA,KAAK,MAAM;AACT,YAAMC,IAAQH,EAAW,QAAQE,CAAK;AACtC,MAAIC,KAAS,KAAGH,EAAW,OAAOG,GAAO,CAAC;AAAA,IAC5C;AAAA,EAAA;AAEJ,GAGaC,IAAa,CAACF,MAA2BF,EAAW,GAAG,EAAE,MAAME,GAkB/DG,IAAiB,MAAeL,EAAW,SAAS;"}

package/build/helpers/label.helper.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=new Set,a=(e,...r)=>{for(const o of r)if(o!==void 0)return o;return process.env.NODE_ENV!=="production"&&!n.has(e)&&(n.add(e),console.error(`[@handijit/ui] Eksik metin: ${e}. Prop olarak geçin ya da <UiProvider labels={…}> içinde bir kez tanımlayın. Metinsiz bırakılan öğe ekran okuyucuda adsız kalır.`)),""},t=(e,r,...o)=>r?r(...o):a(e);exports.resolveFormatter=t;exports.resolveLabel=a;
+//# sourceMappingURL=label.helper.cjs.map

package/build/helpers/label.helper.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.helper.cjs","sources":["../../src/helpers/label.helper.ts"],"sourcesContent":["/** Metin çözümlemesi: prop → sağlayıcı config'i → geliştirme uyarısı. */\n\nimport type { Formatter } from '@/types/theme.type';\n\n/* Uyari ANAHTAR BASINA bir kez verilir. */\nconst warned = new Set<string>();\n\n/** Uyarı durumu testler arasında sızmamalı; her test kendi durumundan başlar. */\nexport const resetLabelWarnings = (): void => warned.clear();\n\n/**\n * Verilen metni çözer.\n * @param key Uyarıda gösterilecek yol (`Modal.closeLabel`).\n * @param values Öncelik sırasına göre adaylar: prop önce, config sonra.\n */\nexport const resolveLabel = (key: string, ...values: (string | undefined)[]): string => {\n  for (const value of values) if (value !== undefined) return value;\n\n  if (process.env.NODE_ENV !== 'production' && !warned.has(key)) {\n    warned.add(key);\n    console.error(\n      `[@handijit/ui] Eksik metin: ${key}. Prop olarak geçin ya da ` +\n        '<UiProvider labels={…}> içinde bir kez tanımlayın. ' +\n        'Metinsiz bırakılan öğe ekran okuyucuda adsız kalır.',\n    );\n  }\n\n  return '';\n};\n\n/** Biçimlendirici çözümü — değere bağlı metinler için. */\nexport const resolveFormatter = <TArgs extends unknown[]>(\n  key: string,\n  formatter: Formatter<TArgs> | undefined,\n  ...args: TArgs\n): string => {\n  if (formatter) return formatter(...args);\n\n  return resolveLabel(key);\n};\n"],"names":["warned","resolveLabel","key","values","value","resolveFormatter","formatter","args"],"mappings":"gFAKA,MAAMA,MAAa,IAUNC,EAAe,CAACC,KAAgBC,IAA2C,CACtF,UAAWC,KAASD,EAAQ,GAAIC,IAAU,OAAW,OAAOA,EAE5D,OAAI,QAAQ,IAAI,WAAa,cAAgB,CAACJ,EAAO,IAAIE,CAAG,IAC1DF,EAAO,IAAIE,CAAG,EACd,QAAQ,MACN,+BAA+BA,CAAG,kIAAA,GAM/B,EACT,EAGaG,EAAmB,CAC9BH,EACAI,KACGC,IAECD,EAAkBA,EAAU,GAAGC,CAAI,EAEhCN,EAAaC,CAAG"}

package/build/helpers/label.helper.d.ts

@@ -0,0 +1,11 @@
+import { Formatter } from '../types/theme.type';
+/** Uyarı durumu testler arasında sızmamalı; her test kendi durumundan başlar. */
+export declare const resetLabelWarnings: () => void;
+/**
+ * Verilen metni çözer.
+ * @param key Uyarıda gösterilecek yol (`Modal.closeLabel`).
+ * @param values Öncelik sırasına göre adaylar: prop önce, config sonra.
+ */
+export declare const resolveLabel: (key: string, ...values: (string | undefined)[]) => string;
+/** Biçimlendirici çözümü — değere bağlı metinler için. */
+export declare const resolveFormatter: <TArgs extends unknown[]>(key: string, formatter: Formatter<TArgs> | undefined, ...args: TArgs) => string;

package/build/helpers/label.helper.js

@@ -0,0 +1,11 @@
+const o = /* @__PURE__ */ new Set(), a = (r, ...e) => {
+  for (const n of e) if (n !== void 0) return n;
+  return process.env.NODE_ENV !== "production" && !o.has(r) && (o.add(r), console.error(
+    `[@handijit/ui] Eksik metin: ${r}. Prop olarak geçin ya da <UiProvider labels={…}> içinde bir kez tanımlayın. Metinsiz bırakılan öğe ekran okuyucuda adsız kalır.`
+  )), "";
+}, i = (r, e, ...n) => e ? e(...n) : a(r);
+export {
+  i as resolveFormatter,
+  a as resolveLabel
+};
+//# sourceMappingURL=label.helper.js.map

package/build/helpers/label.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.helper.js","sources":["../../src/helpers/label.helper.ts"],"sourcesContent":["/** Metin çözümlemesi: prop → sağlayıcı config'i → geliştirme uyarısı. */\n\nimport type { Formatter } from '@/types/theme.type';\n\n/* Uyari ANAHTAR BASINA bir kez verilir. */\nconst warned = new Set<string>();\n\n/** Uyarı durumu testler arasında sızmamalı; her test kendi durumundan başlar. */\nexport const resetLabelWarnings = (): void => warned.clear();\n\n/**\n * Verilen metni çözer.\n * @param key Uyarıda gösterilecek yol (`Modal.closeLabel`).\n * @param values Öncelik sırasına göre adaylar: prop önce, config sonra.\n */\nexport const resolveLabel = (key: string, ...values: (string | undefined)[]): string => {\n  for (const value of values) if (value !== undefined) return value;\n\n  if (process.env.NODE_ENV !== 'production' && !warned.has(key)) {\n    warned.add(key);\n    console.error(\n      `[@handijit/ui] Eksik metin: ${key}. Prop olarak geçin ya da ` +\n        '<UiProvider labels={…}> içinde bir kez tanımlayın. ' +\n        'Metinsiz bırakılan öğe ekran okuyucuda adsız kalır.',\n    );\n  }\n\n  return '';\n};\n\n/** Biçimlendirici çözümü — değere bağlı metinler için. */\nexport const resolveFormatter = <TArgs extends unknown[]>(\n  key: string,\n  formatter: Formatter<TArgs> | undefined,\n  ...args: TArgs\n): string => {\n  if (formatter) return formatter(...args);\n\n  return resolveLabel(key);\n};\n"],"names":["warned","resolveLabel","key","values","value","resolveFormatter","formatter","args"],"mappings":"AAKA,MAAMA,wBAAa,IAAA,GAUNC,IAAe,CAACC,MAAgBC,MAA2C;AACtF,aAAWC,KAASD,EAAQ,KAAIC,MAAU,OAAW,QAAOA;AAE5D,SAAI,QAAQ,IAAI,aAAa,gBAAgB,CAACJ,EAAO,IAAIE,CAAG,MAC1DF,EAAO,IAAIE,CAAG,GACd,QAAQ;AAAA,IACN,+BAA+BA,CAAG;AAAA,EAAA,IAM/B;AACT,GAGaG,IAAmB,CAC9BH,GACAI,MACGC,MAECD,IAAkBA,EAAU,GAAGC,CAAI,IAEhCN,EAAaC,CAAG;"}

package/build/helpers/portal.helper.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=t=>{var e;const o=((e=t==null?void 0:t.closest)==null?void 0:e.call(t,"dialog"))??null;return o&&o.isConnected?{container:o,needsTopLayer:s(o)}:{container:document.body,needsTopLayer:!1}},s=t=>{try{return t.matches(":modal")}catch{return t.hasAttribute("open")}},i={margin:0,right:"auto",bottom:"auto"},n=t=>{if(!t||typeof t.showPopover!="function")return()=>{};try{t.showPopover()}catch{return()=>{}}return()=>{try{t.isConnected&&t.hidePopover()}catch{}}};exports.POPOVER_RESET=i;exports.resolvePortalTarget=r;exports.showTopLayer=n;
+//# sourceMappingURL=portal.helper.cjs.map

package/build/helpers/portal.helper.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal.helper.cjs","sources":["../../src/helpers/portal.helper.ts"],"sourcesContent":["/**\n * Portal hedefi çözümü — üst katman (top layer) farkındalığıyla.\n * ⚠ `createPortal(..., document.body)` TEK BAŞINA YANLIŞ. `<dialog>.showModal()` elemanı\n * tarayıcının **üst katmanına** taşır ve üst katman…\n */\n\n/** Portal hedefi ve o hedefte üst katmana çıkmanın gerekip gerekmediği. */\nexport type PortalTarget = {\n  container: HTMLElement;\n  /** `true` ise yüzey `popover=\"manual\"` taşımalı ve `showPopover()` çağırmalı. */\n  needsTopLayer: boolean;\n};\n\n/**\n * `anchor`ın en yakın açık `<dialog>` atası varsa oraya, yoksa `document.body`e.\n * ⚠ `dialog[open]` yerine `:modal` denenmedi: `show()` ile açılan modalsız bir dialog üst katmana\n * GİRMEZ, ama içine portallamak yine de…\n */\nexport const resolvePortalTarget = (anchor: Element | null | undefined): PortalTarget => {\n  const dialog = anchor?.closest?.('dialog') ?? null;\n\n  if (dialog && dialog.isConnected) {\n    return { container: dialog, needsTopLayer: isTopLayerDialog(dialog) };\n  }\n\n  return { container: document.body, needsTopLayer: false };\n};\n\n/**\n * Dialog üst katmanda mı — yani `showModal()` ile mi açıldı.\n * ⚠ `:modal` bazı ortamlarda (jsdom) desteklenmiyor ve `matches` fırlatıyor\n */\nconst isTopLayerDialog = (dialog: Element): boolean => {\n  try {\n    return dialog.matches(':modal');\n  } catch {\n    return dialog.hasAttribute('open');\n  }\n};\n\n/**\n * Üst katman yüzeyini gösterir; temizleyiciyi döndürür.\n * ⚠ UA stil sayfası `[popover]`a `inset: 0` ve `margin: auto` veriyor.\n */\nexport const POPOVER_RESET = {\n  margin: 0,\n  right: 'auto',\n  bottom: 'auto',\n} as const;\n\n/*\n * Yenilemeyen tek şey satır içi stilin YAZMADIĞI kutu özellikleri: `usePositioning` yalnızca\n * `top`/`left` üretiyor, dolayısıyla UA'nın `inset: 0` +…\n * ⚠ SIFIRLAMA BİLİNÇLİ OLARAK ÜÇ ÖZELLİK.\n */\n\n/** `showPopover()` çağırır ve kapatma fonksiyonunu döndürür. */\nexport const showTopLayer = (element: HTMLElement | null): (() => void) => {\n  if (!element || typeof element.showPopover !== 'function') return () => {};\n\n  try {\n    element.showPopover();\n  } catch {\n    /* Zaten görünürse veya eleman bağlı değilse: yapacak bir şey yok. */\n    return () => {};\n  }\n\n  return () => {\n    try {\n      if (element.isConnected) element.hidePopover();\n    } catch {\n      /* Kapanış sırasında eleman zaten sökülmüş olabilir. */\n    }\n  };\n};\n"],"names":["resolvePortalTarget","anchor","dialog","_a","isTopLayerDialog","POPOVER_RESET","showTopLayer","element"],"mappings":"gFAkBO,MAAMA,EAAuBC,GAAqD,OACvF,MAAMC,IAASC,EAAAF,GAAA,YAAAA,EAAQ,UAAR,YAAAE,EAAA,KAAAF,EAAkB,YAAa,KAE9C,OAAIC,GAAUA,EAAO,YACZ,CAAE,UAAWA,EAAQ,cAAeE,EAAiBF,CAAM,CAAA,EAG7D,CAAE,UAAW,SAAS,KAAM,cAAe,EAAA,CACpD,EAMME,EAAoBF,GAA6B,CACrD,GAAI,CACF,OAAOA,EAAO,QAAQ,QAAQ,CAChC,MAAQ,CACN,OAAOA,EAAO,aAAa,MAAM,CACnC,CACF,EAMaG,EAAgB,CAC3B,OAAQ,EACR,MAAO,OACP,OAAQ,MACV,EASaC,EAAgBC,GAA8C,CACzE,GAAI,CAACA,GAAW,OAAOA,EAAQ,aAAgB,iBAAmB,IAAM,CAAC,EAEzE,GAAI,CACFA,EAAQ,YAAA,CACV,MAAQ,CAEN,MAAO,IAAM,CAAC,CAChB,CAEA,MAAO,IAAM,CACX,GAAI,CACEA,EAAQ,aAAaA,EAAQ,YAAA,CACnC,MAAQ,CAER,CACF,CACF"}

package/build/helpers/portal.helper.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Portal hedefi çözümü — üst katman (top layer) farkındalığıyla.
+ * ⚠ `createPortal(..., document.body)` TEK BAŞINA YANLIŞ. `<dialog>.showModal()` elemanı
+ * tarayıcının **üst katmanına** taşır ve üst katman…
+ */
+/** Portal hedefi ve o hedefte üst katmana çıkmanın gerekip gerekmediği. */
+export type PortalTarget = {
+    container: HTMLElement;
+    /** `true` ise yüzey `popover="manual"` taşımalı ve `showPopover()` çağırmalı. */
+    needsTopLayer: boolean;
+};
+/**
+ * `anchor`ın en yakın açık `<dialog>` atası varsa oraya, yoksa `document.body`e.
+ * ⚠ `dialog[open]` yerine `:modal` denenmedi: `show()` ile açılan modalsız bir dialog üst katmana
+ * GİRMEZ, ama içine portallamak yine de…
+ */
+export declare const resolvePortalTarget: (anchor: Element | null | undefined) => PortalTarget;
+/**
+ * Üst katman yüzeyini gösterir; temizleyiciyi döndürür.
+ * ⚠ UA stil sayfası `[popover]`a `inset: 0` ve `margin: auto` veriyor.
+ */
+export declare const POPOVER_RESET: {
+    readonly margin: 0;
+    readonly right: "auto";
+    readonly bottom: "auto";
+};
+/** `showPopover()` çağırır ve kapatma fonksiyonunu döndürür. */
+export declare const showTopLayer: (element: HTMLElement | null) => (() => void);

package/build/helpers/portal.helper.js

@@ -0,0 +1,36 @@
+const s = (t) => {
+  var r;
+  const o = ((r = t == null ? void 0 : t.closest) == null ? void 0 : r.call(t, "dialog")) ?? null;
+  return o && o.isConnected ? { container: o, needsTopLayer: e(o) } : { container: document.body, needsTopLayer: !1 };
+}, e = (t) => {
+  try {
+    return t.matches(":modal");
+  } catch {
+    return t.hasAttribute("open");
+  }
+}, n = {
+  margin: 0,
+  right: "auto",
+  bottom: "auto"
+}, i = (t) => {
+  if (!t || typeof t.showPopover != "function") return () => {
+  };
+  try {
+    t.showPopover();
+  } catch {
+    return () => {
+    };
+  }
+  return () => {
+    try {
+      t.isConnected && t.hidePopover();
+    } catch {
+    }
+  };
+};
+export {
+  n as POPOVER_RESET,
+  s as resolvePortalTarget,
+  i as showTopLayer
+};
+//# sourceMappingURL=portal.helper.js.map

package/build/helpers/portal.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal.helper.js","sources":["../../src/helpers/portal.helper.ts"],"sourcesContent":["/**\n * Portal hedefi çözümü — üst katman (top layer) farkındalığıyla.\n * ⚠ `createPortal(..., document.body)` TEK BAŞINA YANLIŞ. `<dialog>.showModal()` elemanı\n * tarayıcının **üst katmanına** taşır ve üst katman…\n */\n\n/** Portal hedefi ve o hedefte üst katmana çıkmanın gerekip gerekmediği. */\nexport type PortalTarget = {\n  container: HTMLElement;\n  /** `true` ise yüzey `popover=\"manual\"` taşımalı ve `showPopover()` çağırmalı. */\n  needsTopLayer: boolean;\n};\n\n/**\n * `anchor`ın en yakın açık `<dialog>` atası varsa oraya, yoksa `document.body`e.\n * ⚠ `dialog[open]` yerine `:modal` denenmedi: `show()` ile açılan modalsız bir dialog üst katmana\n * GİRMEZ, ama içine portallamak yine de…\n */\nexport const resolvePortalTarget = (anchor: Element | null | undefined): PortalTarget => {\n  const dialog = anchor?.closest?.('dialog') ?? null;\n\n  if (dialog && dialog.isConnected) {\n    return { container: dialog, needsTopLayer: isTopLayerDialog(dialog) };\n  }\n\n  return { container: document.body, needsTopLayer: false };\n};\n\n/**\n * Dialog üst katmanda mı — yani `showModal()` ile mi açıldı.\n * ⚠ `:modal` bazı ortamlarda (jsdom) desteklenmiyor ve `matches` fırlatıyor\n */\nconst isTopLayerDialog = (dialog: Element): boolean => {\n  try {\n    return dialog.matches(':modal');\n  } catch {\n    return dialog.hasAttribute('open');\n  }\n};\n\n/**\n * Üst katman yüzeyini gösterir; temizleyiciyi döndürür.\n * ⚠ UA stil sayfası `[popover]`a `inset: 0` ve `margin: auto` veriyor.\n */\nexport const POPOVER_RESET = {\n  margin: 0,\n  right: 'auto',\n  bottom: 'auto',\n} as const;\n\n/*\n * Yenilemeyen tek şey satır içi stilin YAZMADIĞI kutu özellikleri: `usePositioning` yalnızca\n * `top`/`left` üretiyor, dolayısıyla UA'nın `inset: 0` +…\n * ⚠ SIFIRLAMA BİLİNÇLİ OLARAK ÜÇ ÖZELLİK.\n */\n\n/** `showPopover()` çağırır ve kapatma fonksiyonunu döndürür. */\nexport const showTopLayer = (element: HTMLElement | null): (() => void) => {\n  if (!element || typeof element.showPopover !== 'function') return () => {};\n\n  try {\n    element.showPopover();\n  } catch {\n    /* Zaten görünürse veya eleman bağlı değilse: yapacak bir şey yok. */\n    return () => {};\n  }\n\n  return () => {\n    try {\n      if (element.isConnected) element.hidePopover();\n    } catch {\n      /* Kapanış sırasında eleman zaten sökülmüş olabilir. */\n    }\n  };\n};\n"],"names":["resolvePortalTarget","anchor","_a","dialog","isTopLayerDialog","POPOVER_RESET","showTopLayer","element"],"mappings":"AAkBO,MAAMA,IAAsB,CAACC,MAAqD;AAAlF,MAAAC;AACL,QAAMC,MAASD,IAAAD,KAAA,gBAAAA,EAAQ,YAAR,gBAAAC,EAAA,KAAAD,GAAkB,cAAa;AAE9C,SAAIE,KAAUA,EAAO,cACZ,EAAE,WAAWA,GAAQ,eAAeC,EAAiBD,CAAM,EAAA,IAG7D,EAAE,WAAW,SAAS,MAAM,eAAe,GAAA;AACpD,GAMMC,IAAmB,CAACD,MAA6B;AACrD,MAAI;AACF,WAAOA,EAAO,QAAQ,QAAQ;AAAA,EAChC,QAAQ;AACN,WAAOA,EAAO,aAAa,MAAM;AAAA,EACnC;AACF,GAMaE,IAAgB;AAAA,EAC3B,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AACV,GASaC,IAAe,CAACC,MAA8C;AACzE,MAAI,CAACA,KAAW,OAAOA,EAAQ,eAAgB,mBAAmB,MAAM;AAAA,EAAC;AAEzE,MAAI;AACF,IAAAA,EAAQ,YAAA;AAAA,EACV,QAAQ;AAEN,WAAO,MAAM;AAAA,IAAC;AAAA,EAChB;AAEA,SAAO,MAAM;AACX,QAAI;AACF,MAAIA,EAAQ,eAAaA,EAAQ,YAAA;AAAA,IACnC,QAAQ;AAAA,IAER;AAAA,EACF;AACF;"}

package/build/helpers/scroll.helper.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("@handijit/utils"),l=()=>{!s.isClient()||typeof window.scrollTo!="function"||window.scrollTo({top:0,left:0,behavior:"instant"})},t=(o,i)=>{typeof(o==null?void 0:o.scrollIntoView)=="function"&&o.scrollIntoView(i)};exports.scrollIntoViewIfPossible=t;exports.scrollWindowToTop=l;
+//# sourceMappingURL=scroll.helper.cjs.map

package/build/helpers/scroll.helper.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.helper.cjs","sources":["../../src/helpers/scroll.helper.ts"],"sourcesContent":["/** Kaydırma yardımcıları. */\n\nimport { isClient } from '@handijit/utils';\n\n/**\n * Pencereyi en üste alır; ortam desteklemiyorsa sessizce geçer.\n * ⚠ Kaydırma ANIDIR.\n */\nexport const scrollWindowToTop = (): void => {\n  if (!isClient() || typeof window.scrollTo !== 'function') return;\n\n  window.scrollTo({ top: 0, left: 0, behavior: 'instant' });\n};\n\n/** Öğeyi görünür alana kaydırır; ortam desteklemiyorsa sessizce geçer. */\nexport const scrollIntoViewIfPossible = (\n  element: Element | null | undefined,\n  options?: ScrollIntoViewOptions,\n): void => {\n  if (typeof element?.scrollIntoView === 'function') element.scrollIntoView(options);\n};\n"],"names":["scrollWindowToTop","isClient","scrollIntoViewIfPossible","element","options"],"mappings":"mHAQaA,EAAoB,IAAY,CACvC,CAACC,EAAAA,SAAA,GAAc,OAAO,OAAO,UAAa,YAE9C,OAAO,SAAS,CAAE,IAAK,EAAG,KAAM,EAAG,SAAU,UAAW,CAC1D,EAGaC,EAA2B,CACtCC,EACAC,IACS,CACL,OAAOD,GAAA,YAAAA,EAAS,iBAAmB,YAAYA,EAAQ,eAAeC,CAAO,CACnF"}

package/build/helpers/scroll.helper.d.ts

@@ -0,0 +1,8 @@
+/** Kaydırma yardımcıları. */
+/**
+ * Pencereyi en üste alır; ortam desteklemiyorsa sessizce geçer.
+ * ⚠ Kaydırma ANIDIR.
+ */
+export declare const scrollWindowToTop: () => void;
+/** Öğeyi görünür alana kaydırır; ortam desteklemiyorsa sessizce geçer. */
+export declare const scrollIntoViewIfPossible: (element: Element | null | undefined, options?: ScrollIntoViewOptions) => void;

package/build/helpers/scroll.helper.js

@@ -0,0 +1,11 @@
+import { isClient as r } from "@handijit/utils";
+const t = () => {
+  !r() || typeof window.scrollTo != "function" || window.scrollTo({ top: 0, left: 0, behavior: "instant" });
+}, n = (o, i) => {
+  typeof (o == null ? void 0 : o.scrollIntoView) == "function" && o.scrollIntoView(i);
+};
+export {
+  n as scrollIntoViewIfPossible,
+  t as scrollWindowToTop
+};
+//# sourceMappingURL=scroll.helper.js.map

package/build/helpers/scroll.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.helper.js","sources":["../../src/helpers/scroll.helper.ts"],"sourcesContent":["/** Kaydırma yardımcıları. */\n\nimport { isClient } from '@handijit/utils';\n\n/**\n * Pencereyi en üste alır; ortam desteklemiyorsa sessizce geçer.\n * ⚠ Kaydırma ANIDIR.\n */\nexport const scrollWindowToTop = (): void => {\n  if (!isClient() || typeof window.scrollTo !== 'function') return;\n\n  window.scrollTo({ top: 0, left: 0, behavior: 'instant' });\n};\n\n/** Öğeyi görünür alana kaydırır; ortam desteklemiyorsa sessizce geçer. */\nexport const scrollIntoViewIfPossible = (\n  element: Element | null | undefined,\n  options?: ScrollIntoViewOptions,\n): void => {\n  if (typeof element?.scrollIntoView === 'function') element.scrollIntoView(options);\n};\n"],"names":["scrollWindowToTop","isClient","scrollIntoViewIfPossible","element","options"],"mappings":";AAQO,MAAMA,IAAoB,MAAY;AAC3C,EAAI,CAACC,EAAA,KAAc,OAAO,OAAO,YAAa,cAE9C,OAAO,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,WAAW;AAC1D,GAGaC,IAA2B,CACtCC,GACAC,MACS;AACT,EAAI,QAAOD,KAAA,gBAAAA,EAAS,mBAAmB,cAAYA,EAAQ,eAAeC,CAAO;AACnF;"}

package/build/helpers/text.helper.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=e=>e.replace(/İ/g,"i").replace(/I/g,"i").replace(/ı/g,"i").toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g,"").replace(/ş/g,"s").replace(/ğ/g,"g").replace(/ç/g,"c").replace(/ø/g,"o").replace(/æ/g,"ae").replace(/ß/g,"ss").replace(/đ/g,"d").replace(/ł/g,"l").replace(/\s+/g," ").trim(),c=(e,a)=>r(e).includes(r(a));exports.matchesSearch=c;exports.normalizeSearchTerm=r;
+//# sourceMappingURL=text.helper.cjs.map

package/build/helpers/text.helper.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.helper.cjs","sources":["../../src/helpers/text.helper.ts"],"sourcesContent":["/** Metin normalizasyonu — aksan ve büyük/küçük harf duyarsız arama. */\n\n/** Serbest metin arama anahtarı: */\nexport const normalizeSearchTerm = (value: string): string =>\n  value\n    .replace(/İ/g, 'i')\n    .replace(/I/g, 'i')\n    .replace(/ı/g, 'i')\n    .toLowerCase()\n    .normalize('NFD')\n    /* Birlestirici aksan isaretleri (U+0300–U+036F). */\n    .replace(/[\\u0300-\\u036f]/g, '')\n    /* NFD'nin ayristirmadigi harfler: her biri tek kod noktasi. */\n    .replace(/ş/g, 's')\n    .replace(/ğ/g, 'g')\n    .replace(/ç/g, 'c')\n    .replace(/ø/g, 'o')\n    .replace(/æ/g, 'ae')\n    .replace(/ß/g, 'ss')\n    .replace(/đ/g, 'd')\n    .replace(/ł/g, 'l')\n    .replace(/\\s+/g, ' ')\n    .trim();\n\n/** Aranan metin, hedefin içinde geçiyor mu? */\nexport const matchesSearch = (haystack: string, needle: string): boolean =>\n  normalizeSearchTerm(haystack).includes(normalizeSearchTerm(needle));\n"],"names":["normalizeSearchTerm","value","matchesSearch","haystack","needle"],"mappings":"gFAGO,MAAMA,EAAuBC,GAClCA,EACG,QAAQ,KAAM,GAAG,EACjB,QAAQ,KAAM,GAAG,EACjB,QAAQ,KAAM,GAAG,EACjB,YAAA,EACA,UAAU,KAAK,EAEf,QAAQ,mBAAoB,EAAE,EAE9B,QAAQ,KAAM,GAAG,EACjB,QAAQ,KAAM,GAAG,EACjB,QAAQ,KAAM,GAAG,EACjB,QAAQ,KAAM,GAAG,EACjB,QAAQ,KAAM,IAAI,EAClB,QAAQ,KAAM,IAAI,EAClB,QAAQ,KAAM,GAAG,EACjB,QAAQ,KAAM,GAAG,EACjB,QAAQ,OAAQ,GAAG,EACnB,KAAA,EAGQC,EAAgB,CAACC,EAAkBC,IAC9CJ,EAAoBG,CAAQ,EAAE,SAASH,EAAoBI,CAAM,CAAC"}

package/build/helpers/text.helper.d.ts

@@ -0,0 +1,5 @@
+/** Metin normalizasyonu — aksan ve büyük/küçük harf duyarsız arama. */
+/** Serbest metin arama anahtarı: */
+export declare const normalizeSearchTerm: (value: string) => string;
+/** Aranan metin, hedefin içinde geçiyor mu? */
+export declare const matchesSearch: (haystack: string, needle: string) => boolean;

package/build/helpers/text.helper.js

@@ -0,0 +1,6 @@
+const r = (e) => e.replace(/İ/g, "i").replace(/I/g, "i").replace(/ı/g, "i").toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/ş/g, "s").replace(/ğ/g, "g").replace(/ç/g, "c").replace(/ø/g, "o").replace(/æ/g, "ae").replace(/ß/g, "ss").replace(/đ/g, "d").replace(/ł/g, "l").replace(/\s+/g, " ").trim(), c = (e, a) => r(e).includes(r(a));
+export {
+  c as matchesSearch,
+  r as normalizeSearchTerm
+};
+//# sourceMappingURL=text.helper.js.map

package/build/helpers/text.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.helper.js","sources":["../../src/helpers/text.helper.ts"],"sourcesContent":["/** Metin normalizasyonu — aksan ve büyük/küçük harf duyarsız arama. */\n\n/** Serbest metin arama anahtarı: */\nexport const normalizeSearchTerm = (value: string): string =>\n  value\n    .replace(/İ/g, 'i')\n    .replace(/I/g, 'i')\n    .replace(/ı/g, 'i')\n    .toLowerCase()\n    .normalize('NFD')\n    /* Birlestirici aksan isaretleri (U+0300–U+036F). */\n    .replace(/[\\u0300-\\u036f]/g, '')\n    /* NFD'nin ayristirmadigi harfler: her biri tek kod noktasi. */\n    .replace(/ş/g, 's')\n    .replace(/ğ/g, 'g')\n    .replace(/ç/g, 'c')\n    .replace(/ø/g, 'o')\n    .replace(/æ/g, 'ae')\n    .replace(/ß/g, 'ss')\n    .replace(/đ/g, 'd')\n    .replace(/ł/g, 'l')\n    .replace(/\\s+/g, ' ')\n    .trim();\n\n/** Aranan metin, hedefin içinde geçiyor mu? */\nexport const matchesSearch = (haystack: string, needle: string): boolean =>\n  normalizeSearchTerm(haystack).includes(normalizeSearchTerm(needle));\n"],"names":["normalizeSearchTerm","value","matchesSearch","haystack","needle"],"mappings":"AAGO,MAAMA,IAAsB,CAACC,MAClCA,EACG,QAAQ,MAAM,GAAG,EACjB,QAAQ,MAAM,GAAG,EACjB,QAAQ,MAAM,GAAG,EACjB,YAAA,EACA,UAAU,KAAK,EAEf,QAAQ,oBAAoB,EAAE,EAE9B,QAAQ,MAAM,GAAG,EACjB,QAAQ,MAAM,GAAG,EACjB,QAAQ,MAAM,GAAG,EACjB,QAAQ,MAAM,GAAG,EACjB,QAAQ,MAAM,IAAI,EAClB,QAAQ,MAAM,IAAI,EAClB,QAAQ,MAAM,GAAG,EACjB,QAAQ,MAAM,GAAG,EACjB,QAAQ,QAAQ,GAAG,EACnB,KAAA,GAGQC,IAAgB,CAACC,GAAkBC,MAC9CJ,EAAoBG,CAAQ,EAAE,SAASH,EAAoBI,CAAM,CAAC;"}

package/build/helpers/theme.helper.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("@handijit/design"),r=require("@handijit/utils"),n="ui-theme-switching",o="(prefers-color-scheme: dark)",i=e=>e==="light"||e==="dark",s=()=>{var e;return r.isClient()&&((e=window.matchMedia)!=null&&e.call(window,o).matches)?"dark":"light"},c=()=>{if(!r.isClient())return"system";try{const e=window.localStorage.getItem(t.THEME_STORAGE_KEY);return i(e)?e:"system"}catch{return"system"}},m=()=>{if(!r.isClient())return"light";const e=document.documentElement.getAttribute(t.THEME_ATTRIBUTE);return i(e)?e:s()},T=e=>{if(r.isClient()){try{e==="system"?window.localStorage.removeItem(t.THEME_STORAGE_KEY):window.localStorage.setItem(t.THEME_STORAGE_KEY,e)}catch{}document.documentElement.setAttribute(t.THEME_ATTRIBUTE,e==="system"?s():e)}};exports.THEME_SWITCHING_CLASS=n;exports.applyThemePreference=T;exports.readActiveTheme=m;exports.readStoredPreference=c;exports.readSystemTheme=s;
+//# sourceMappingURL=theme.helper.cjs.map

package/build/helpers/theme.helper.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.helper.cjs","sources":["../../src/helpers/theme.helper.ts"],"sourcesContent":["import {\n  THEME_ATTRIBUTE,\n  THEME_STORAGE_KEY,\n  type ThemeName,\n  type ThemePreference,\n} from '@handijit/design';\nimport { isClient } from '@handijit/utils';\n\n/** Turns transitions off for one frame while the theme flips (see `base.scss`). */\nexport const THEME_SWITCHING_CLASS = 'ui-theme-switching';\n\nconst DARK_QUERY = '(prefers-color-scheme: dark)';\n\nconst isThemeName = (value: unknown): value is ThemeName => value === 'light' || value === 'dark';\n\n/** The operating system's setting; `light` on the server. */\nexport const readSystemTheme = (): ThemeName =>\n  isClient() && window.matchMedia?.(DARK_QUERY).matches ? 'dark' : 'light';\n\n/**\n * The user's stored choice. \"System\" is the absence of the key, and a storage that throws (private\n * window, blocked site data) counts as no choice — the same reading as the design boot script.\n */\nexport const readStoredPreference = (): ThemePreference => {\n  if (!isClient()) return 'system';\n\n  try {\n    const stored = window.localStorage.getItem(THEME_STORAGE_KEY);\n    return isThemeName(stored) ? stored : 'system';\n  } catch {\n    return 'system';\n  }\n};\n\n/** The theme drawn on the page: the root attribute when it names a theme, else the system's. */\nexport const readActiveTheme = (): ThemeName => {\n  if (!isClient()) return 'light';\n\n  const attribute = document.documentElement.getAttribute(THEME_ATTRIBUTE);\n  return isThemeName(attribute) ? attribute : readSystemTheme();\n};\n\n/**\n * Stores the choice and applies it to the root element, the way `@handijit/design` documents it:\n * only `light` / `dark` are stored, \"system\" removes the key, and the attribute always carries the\n * resolved theme so the boot script and this function agree.\n */\nexport const applyThemePreference = (preference: ThemePreference): void => {\n  if (!isClient()) return;\n\n  try {\n    if (preference === 'system') window.localStorage.removeItem(THEME_STORAGE_KEY);\n    else window.localStorage.setItem(THEME_STORAGE_KEY, preference);\n  } catch {\n    /* The choice still applies for this page view; it just cannot be remembered. */\n  }\n\n  document.documentElement.setAttribute(\n    THEME_ATTRIBUTE,\n    preference === 'system' ? readSystemTheme() : preference,\n  );\n};\n"],"names":["THEME_SWITCHING_CLASS","DARK_QUERY","isThemeName","value","readSystemTheme","isClient","_a","readStoredPreference","stored","THEME_STORAGE_KEY","readActiveTheme","attribute","THEME_ATTRIBUTE","applyThemePreference","preference"],"mappings":"iJASaA,EAAwB,qBAE/BC,EAAa,+BAEbC,EAAeC,GAAuCA,IAAU,SAAWA,IAAU,OAG9EC,EAAkB,IAAA,OAC7BC,OAAAA,EAAAA,SAAA,KAAcC,EAAA,OAAO,aAAP,MAAAA,EAAA,YAAoBL,GAAY,SAAU,OAAS,SAMtDM,EAAuB,IAAuB,CACzD,GAAI,CAACF,EAAAA,SAAA,EAAY,MAAO,SAExB,GAAI,CACF,MAAMG,EAAS,OAAO,aAAa,QAAQC,EAAAA,iBAAiB,EAC5D,OAAOP,EAAYM,CAAM,EAAIA,EAAS,QACxC,MAAQ,CACN,MAAO,QACT,CACF,EAGaE,EAAkB,IAAiB,CAC9C,GAAI,CAACL,EAAAA,SAAA,EAAY,MAAO,QAExB,MAAMM,EAAY,SAAS,gBAAgB,aAAaC,EAAAA,eAAe,EACvE,OAAOV,EAAYS,CAAS,EAAIA,EAAYP,EAAA,CAC9C,EAOaS,EAAwBC,GAAsC,CACzE,GAAKT,EAAAA,WAEL,IAAI,CACES,IAAe,SAAU,OAAO,aAAa,WAAWL,EAAAA,iBAAiB,EACxE,OAAO,aAAa,QAAQA,EAAAA,kBAAmBK,CAAU,CAChE,MAAQ,CAER,CAEA,SAAS,gBAAgB,aACvBF,EAAAA,gBACAE,IAAe,SAAWV,IAAoBU,CAAA,EAElD"}

package/build/helpers/theme.helper.d.ts

@@ -0,0 +1,18 @@
+import { ThemeName, ThemePreference } from '@handijit/design';
+/** Turns transitions off for one frame while the theme flips (see `base.scss`). */
+export declare const THEME_SWITCHING_CLASS = "ui-theme-switching";
+/** The operating system's setting; `light` on the server. */
+export declare const readSystemTheme: () => ThemeName;
+/**
+ * The user's stored choice. "System" is the absence of the key, and a storage that throws (private
+ * window, blocked site data) counts as no choice — the same reading as the design boot script.
+ */
+export declare const readStoredPreference: () => ThemePreference;
+/** The theme drawn on the page: the root attribute when it names a theme, else the system's. */
+export declare const readActiveTheme: () => ThemeName;
+/**
+ * Stores the choice and applies it to the root element, the way `@handijit/design` documents it:
+ * only `light` / `dark` are stored, "system" removes the key, and the attribute always carries the
+ * resolved theme so the boot script and this function agree.
+ */
+export declare const applyThemePreference: (preference: ThemePreference) => void;

package/build/helpers/theme.helper.js

@@ -0,0 +1,37 @@
+import { THEME_STORAGE_KEY as r, THEME_ATTRIBUTE as o } from "@handijit/design";
+import { isClient as e } from "@handijit/utils";
+const a = "ui-theme-switching", n = "(prefers-color-scheme: dark)", s = (t) => t === "light" || t === "dark", m = () => {
+  var t;
+  return e() && ((t = window.matchMedia) != null && t.call(window, n).matches) ? "dark" : "light";
+}, d = () => {
+  if (!e()) return "system";
+  try {
+    const t = window.localStorage.getItem(r);
+    return s(t) ? t : "system";
+  } catch {
+    return "system";
+  }
+}, h = () => {
+  if (!e()) return "light";
+  const t = document.documentElement.getAttribute(o);
+  return s(t) ? t : m();
+}, l = (t) => {
+  if (e()) {
+    try {
+      t === "system" ? window.localStorage.removeItem(r) : window.localStorage.setItem(r, t);
+    } catch {
+    }
+    document.documentElement.setAttribute(
+      o,
+      t === "system" ? m() : t
+    );
+  }
+};
+export {
+  a as THEME_SWITCHING_CLASS,
+  l as applyThemePreference,
+  h as readActiveTheme,
+  d as readStoredPreference,
+  m as readSystemTheme
+};
+//# sourceMappingURL=theme.helper.js.map

package/build/helpers/theme.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.helper.js","sources":["../../src/helpers/theme.helper.ts"],"sourcesContent":["import {\n  THEME_ATTRIBUTE,\n  THEME_STORAGE_KEY,\n  type ThemeName,\n  type ThemePreference,\n} from '@handijit/design';\nimport { isClient } from '@handijit/utils';\n\n/** Turns transitions off for one frame while the theme flips (see `base.scss`). */\nexport const THEME_SWITCHING_CLASS = 'ui-theme-switching';\n\nconst DARK_QUERY = '(prefers-color-scheme: dark)';\n\nconst isThemeName = (value: unknown): value is ThemeName => value === 'light' || value === 'dark';\n\n/** The operating system's setting; `light` on the server. */\nexport const readSystemTheme = (): ThemeName =>\n  isClient() && window.matchMedia?.(DARK_QUERY).matches ? 'dark' : 'light';\n\n/**\n * The user's stored choice. \"System\" is the absence of the key, and a storage that throws (private\n * window, blocked site data) counts as no choice — the same reading as the design boot script.\n */\nexport const readStoredPreference = (): ThemePreference => {\n  if (!isClient()) return 'system';\n\n  try {\n    const stored = window.localStorage.getItem(THEME_STORAGE_KEY);\n    return isThemeName(stored) ? stored : 'system';\n  } catch {\n    return 'system';\n  }\n};\n\n/** The theme drawn on the page: the root attribute when it names a theme, else the system's. */\nexport const readActiveTheme = (): ThemeName => {\n  if (!isClient()) return 'light';\n\n  const attribute = document.documentElement.getAttribute(THEME_ATTRIBUTE);\n  return isThemeName(attribute) ? attribute : readSystemTheme();\n};\n\n/**\n * Stores the choice and applies it to the root element, the way `@handijit/design` documents it:\n * only `light` / `dark` are stored, \"system\" removes the key, and the attribute always carries the\n * resolved theme so the boot script and this function agree.\n */\nexport const applyThemePreference = (preference: ThemePreference): void => {\n  if (!isClient()) return;\n\n  try {\n    if (preference === 'system') window.localStorage.removeItem(THEME_STORAGE_KEY);\n    else window.localStorage.setItem(THEME_STORAGE_KEY, preference);\n  } catch {\n    /* The choice still applies for this page view; it just cannot be remembered. */\n  }\n\n  document.documentElement.setAttribute(\n    THEME_ATTRIBUTE,\n    preference === 'system' ? readSystemTheme() : preference,\n  );\n};\n"],"names":["THEME_SWITCHING_CLASS","DARK_QUERY","isThemeName","value","readSystemTheme","isClient","_a","readStoredPreference","stored","THEME_STORAGE_KEY","readActiveTheme","attribute","THEME_ATTRIBUTE","applyThemePreference","preference"],"mappings":";;AASO,MAAMA,IAAwB,sBAE/BC,IAAa,gCAEbC,IAAc,CAACC,MAAuCA,MAAU,WAAWA,MAAU,QAG9EC,IAAkB,MAAA;;AAC7B,SAAAC,EAAA,OAAcC,IAAA,OAAO,eAAP,QAAAA,EAAA,aAAoBL,GAAY,WAAU,SAAS;AAAA,GAMtDM,IAAuB,MAAuB;AACzD,MAAI,CAACF,EAAA,EAAY,QAAO;AAExB,MAAI;AACF,UAAMG,IAAS,OAAO,aAAa,QAAQC,CAAiB;AAC5D,WAAOP,EAAYM,CAAM,IAAIA,IAAS;AAAA,EACxC,QAAQ;AACN,WAAO;AAAA,EACT;AACF,GAGaE,IAAkB,MAAiB;AAC9C,MAAI,CAACL,EAAA,EAAY,QAAO;AAExB,QAAMM,IAAY,SAAS,gBAAgB,aAAaC,CAAe;AACvE,SAAOV,EAAYS,CAAS,IAAIA,IAAYP,EAAA;AAC9C,GAOaS,IAAuB,CAACC,MAAsC;AACzE,MAAKT,KAEL;AAAA,QAAI;AACF,MAAIS,MAAe,WAAU,OAAO,aAAa,WAAWL,CAAiB,IACxE,OAAO,aAAa,QAAQA,GAAmBK,CAAU;AAAA,IAChE,QAAQ;AAAA,IAER;AAEA,aAAS,gBAAgB;AAAA,MACvBF;AAAA,MACAE,MAAe,WAAWV,MAAoBU;AAAA,IAAA;AAAA;AAElD;"}

package/build/hooks/useAnnounce.cjs

@@ -0,0 +1,2 @@
+"use client";"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("react"),o=require("@handijit/utils"),u="ui-live-region",s=t=>{if(!o.isClient())return null;const i=`${u}-${t}`,n=document.getElementById(i);if(n)return n;const e=document.createElement("div");return e.id=i,e.setAttribute("aria-live",t),e.setAttribute("aria-atomic","true"),e.className="ui-visually-hidden",document.body.appendChild(e),e},c=(t,i)=>{t.textContent="",window.requestAnimationFrame(()=>{t.textContent=i})},l=()=>r.useCallback((t,i="polite")=>{const n=t.trim();if(n==="")return;const e=s(i);e&&c(e,n)},[]);exports.default=l;
+//# sourceMappingURL=useAnnounce.cjs.map

package/build/hooks/useAnnounce.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnnounce.cjs","sources":["../../src/hooks/useAnnounce.ts"],"sourcesContent":["'use client';\n\nimport { useCallback } from 'react';\n\nimport { isClient } from '@handijit/utils';\nimport { AnnouncePoliteness } from '@/types/hook.type';\n\n/**\n * EKRAN OKUYUCU DUYURU MERKEZİ.\n * @example const announce = useAnnounce(); announce(`${count} ürün bulundu`)\n */\n\nconst REGION_ID = 'ui-live-region';\n\n/** Bölgeyi bulur; yoksa oluşturur. */\nconst getRegion = (politeness: AnnouncePoliteness): HTMLElement | null => {\n  if (!isClient()) return null;\n\n  const id = `${REGION_ID}-${politeness}`;\n  const existing = document.getElementById(id);\n  if (existing) return existing;\n\n  const region = document.createElement('div');\n  region.id = id;\n  region.setAttribute('aria-live', politeness);\n  /* `aria-atomic` — bolge her degistiginde TAMAMI okunur. */\n  region.setAttribute('aria-atomic', 'true');\n  /*\n   * Gorsel olarak gizli ama DOM'da: `display: none` ya da `hidden` bolgeyi erisilebilirlik\n   * agacindan da cikarir ve hicbir sey duyurulmaz.\n   */\n  region.className = 'ui-visually-hidden';\n\n  document.body.appendChild(region);\n  return region;\n};\n\n/** AYNI metni arka arkaya duyurmak. */\nconst write = (region: HTMLElement, message: string): void => {\n  region.textContent = '';\n\n  window.requestAnimationFrame(() => {\n    region.textContent = message;\n  });\n};\n\n/** Duyuru fonksiyonu döndürür. */\nconst useAnnounce = (): ((message: string, politeness?: AnnouncePoliteness) => void) =>\n  useCallback((message: string, politeness: AnnouncePoliteness = 'polite') => {\n    const trimmed = message.trim();\n    /* Bos duyuru bolgeyi temizler ve bir sonraki gercek duyuruyu bastirir. */\n    if (trimmed === '') return;\n\n    const region = getRegion(politeness);\n    if (region) write(region, trimmed);\n  }, []);\n\nexport default useAnnounce;\n"],"names":["REGION_ID","getRegion","politeness","isClient","id","existing","region","write","message","useAnnounce","useCallback","trimmed"],"mappings":"+KAWMA,EAAY,iBAGZC,EAAaC,GAAuD,CACxE,GAAI,CAACC,EAAAA,SAAA,EAAY,OAAO,KAExB,MAAMC,EAAK,GAAGJ,CAAS,IAAIE,CAAU,GAC/BG,EAAW,SAAS,eAAeD,CAAE,EAC3C,GAAIC,EAAU,OAAOA,EAErB,MAAMC,EAAS,SAAS,cAAc,KAAK,EAC3C,OAAAA,EAAO,GAAKF,EACZE,EAAO,aAAa,YAAaJ,CAAU,EAE3CI,EAAO,aAAa,cAAe,MAAM,EAKzCA,EAAO,UAAY,qBAEnB,SAAS,KAAK,YAAYA,CAAM,EACzBA,CACT,EAGMC,EAAQ,CAACD,EAAqBE,IAA0B,CAC5DF,EAAO,YAAc,GAErB,OAAO,sBAAsB,IAAM,CACjCA,EAAO,YAAcE,CACvB,CAAC,CACH,EAGMC,EAAc,IAClBC,EAAAA,YAAY,CAACF,EAAiBN,EAAiC,WAAa,CAC1E,MAAMS,EAAUH,EAAQ,KAAA,EAExB,GAAIG,IAAY,GAAI,OAEpB,MAAML,EAASL,EAAUC,CAAU,EAC/BI,GAAQC,EAAMD,EAAQK,CAAO,CACnC,EAAG,CAAA,CAAE"}

package/build/hooks/useAnnounce.d.ts

@@ -0,0 +1,4 @@
+import { AnnouncePoliteness } from '../types/hook.type';
+/** Duyuru fonksiyonu döndürür. */
+declare const useAnnounce: () => ((message: string, politeness?: AnnouncePoliteness) => void);
+export default useAnnounce;

package/build/hooks/useAnnounce.js

@@ -0,0 +1,23 @@
+"use client";
+import { useCallback as o } from "react";
+import { isClient as r } from "@handijit/utils";
+const u = "ui-live-region", s = (e) => {
+  if (!r()) return null;
+  const n = `${u}-${e}`, i = document.getElementById(n);
+  if (i) return i;
+  const t = document.createElement("div");
+  return t.id = n, t.setAttribute("aria-live", e), t.setAttribute("aria-atomic", "true"), t.className = "ui-visually-hidden", document.body.appendChild(t), t;
+}, c = (e, n) => {
+  e.textContent = "", window.requestAnimationFrame(() => {
+    e.textContent = n;
+  });
+}, d = () => o((e, n = "polite") => {
+  const i = e.trim();
+  if (i === "") return;
+  const t = s(n);
+  t && c(t, i);
+}, []);
+export {
+  d as default
+};
+//# sourceMappingURL=useAnnounce.js.map

package/build/hooks/useAnnounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnnounce.js","sources":["../../src/hooks/useAnnounce.ts"],"sourcesContent":["'use client';\n\nimport { useCallback } from 'react';\n\nimport { isClient } from '@handijit/utils';\nimport { AnnouncePoliteness } from '@/types/hook.type';\n\n/**\n * EKRAN OKUYUCU DUYURU MERKEZİ.\n * @example const announce = useAnnounce(); announce(`${count} ürün bulundu`)\n */\n\nconst REGION_ID = 'ui-live-region';\n\n/** Bölgeyi bulur; yoksa oluşturur. */\nconst getRegion = (politeness: AnnouncePoliteness): HTMLElement | null => {\n  if (!isClient()) return null;\n\n  const id = `${REGION_ID}-${politeness}`;\n  const existing = document.getElementById(id);\n  if (existing) return existing;\n\n  const region = document.createElement('div');\n  region.id = id;\n  region.setAttribute('aria-live', politeness);\n  /* `aria-atomic` — bolge her degistiginde TAMAMI okunur. */\n  region.setAttribute('aria-atomic', 'true');\n  /*\n   * Gorsel olarak gizli ama DOM'da: `display: none` ya da `hidden` bolgeyi erisilebilirlik\n   * agacindan da cikarir ve hicbir sey duyurulmaz.\n   */\n  region.className = 'ui-visually-hidden';\n\n  document.body.appendChild(region);\n  return region;\n};\n\n/** AYNI metni arka arkaya duyurmak. */\nconst write = (region: HTMLElement, message: string): void => {\n  region.textContent = '';\n\n  window.requestAnimationFrame(() => {\n    region.textContent = message;\n  });\n};\n\n/** Duyuru fonksiyonu döndürür. */\nconst useAnnounce = (): ((message: string, politeness?: AnnouncePoliteness) => void) =>\n  useCallback((message: string, politeness: AnnouncePoliteness = 'polite') => {\n    const trimmed = message.trim();\n    /* Bos duyuru bolgeyi temizler ve bir sonraki gercek duyuruyu bastirir. */\n    if (trimmed === '') return;\n\n    const region = getRegion(politeness);\n    if (region) write(region, trimmed);\n  }, []);\n\nexport default useAnnounce;\n"],"names":["REGION_ID","getRegion","politeness","isClient","id","existing","region","write","message","useAnnounce","useCallback","trimmed"],"mappings":";;;AAWA,MAAMA,IAAY,kBAGZC,IAAY,CAACC,MAAuD;AACxE,MAAI,CAACC,EAAA,EAAY,QAAO;AAExB,QAAMC,IAAK,GAAGJ,CAAS,IAAIE,CAAU,IAC/BG,IAAW,SAAS,eAAeD,CAAE;AAC3C,MAAIC,EAAU,QAAOA;AAErB,QAAMC,IAAS,SAAS,cAAc,KAAK;AAC3C,SAAAA,EAAO,KAAKF,GACZE,EAAO,aAAa,aAAaJ,CAAU,GAE3CI,EAAO,aAAa,eAAe,MAAM,GAKzCA,EAAO,YAAY,sBAEnB,SAAS,KAAK,YAAYA,CAAM,GACzBA;AACT,GAGMC,IAAQ,CAACD,GAAqBE,MAA0B;AAC5D,EAAAF,EAAO,cAAc,IAErB,OAAO,sBAAsB,MAAM;AACjC,IAAAA,EAAO,cAAcE;AAAA,EACvB,CAAC;AACH,GAGMC,IAAc,MAClBC,EAAY,CAACF,GAAiBN,IAAiC,aAAa;AAC1E,QAAMS,IAAUH,EAAQ,KAAA;AAExB,MAAIG,MAAY,GAAI;AAEpB,QAAML,IAASL,EAAUC,CAAU;AACnC,EAAII,KAAQC,EAAMD,GAAQK,CAAO;AACnC,GAAG,CAAA,CAAE;"}

package/build/hooks/useAsyncSearch.cjs

@@ -0,0 +1,2 @@
+"use client";"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const o=require("react"),s=(t,r,u,n)=>{const e=o.useRef(u);e.current=u,o.useEffect(()=>{if(!r||!e.current)return;const i=window.setTimeout(()=>{var c;return(c=e.current)==null?void 0:c.call(e,t.trim())},n);return()=>window.clearTimeout(i)},[t,r,n])};exports.default=s;
+//# sourceMappingURL=useAsyncSearch.cjs.map