@handijit/ui 0.0.0-stage → 1.0.0

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,24 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("@handijit/utils"),d=require("../theme/tokens.cjs"),T="--ui-",c="ui-theme-overrides",l="data-ui-theme",u="data-ui-density",_="ui-theme-switching",h="ui",r="html:root",S=(t,e)=>{const n=t==="dark"?d.DARK_THEME:d.LIGHT_THEME,o=(t==="dark"?e==null?void 0:e.dark:e==null?void 0:e.light)??{};return{...n,...o}},m=t=>{const e=[],n=(s,E="  ")=>Object.entries(s).map(([$,p])=>`${E}${T}${$}: ${p};`).join(`
+`),o=t.fonts??{},i=Object.entries(o).filter(([,s])=>!!s);i.length>0&&e.push(`${r} {
+${i.map(([s,E])=>`  ${T}font-${s}: ${E};`).join(`
+`)}
+}`);const a=t.metrics??{};if(Object.keys(a).length>0){const s=n(a);e.push(`${r} {
+${s}
+}`),e.push(`${r}[${u}='compact'] {
+${s}
+}`)}if(t.light&&Object.keys(t.light).length>0){const s=n(t.light);e.push(`${r} {
+${s}
+}`),e.push(`${r}[${l}='light'] {
+${s}
+}`)}if(t.dark&&Object.keys(t.dark).length>0){const s=n(t.dark);e.push(`${r}[${l}='dark'] {
+${s}
+}`),e.push(`@media (prefers-color-scheme: dark) {
+  ${r}:not([${l}]) {
+${n(t.dark,"    ")}
+  }
+}`)}return e.length===0?"":`@layer ${h} {
+${e.join(`
+
+`).replace(/^(?=.)/gm,"  ")}
+}`},k=t=>t.replace(/<\/style/gi,"<\\/style"),I=t=>{if(!y.isClient())return;const e=t?m(t):"",n=document.getElementById(c);if(e===""){n==null||n.remove();return}const o=n??document.createElement("style");o.id=c,o.textContent=e,n||document.head.appendChild(o)},H=({storageKey:t})=>`(function(){try{var t=localStorage.getItem(${JSON.stringify(t)});if(t==="light"||t==="dark")document.documentElement.setAttribute("${l}",t)}catch(e){}})()`;exports.DENSITY_ATTRIBUTE=u;exports.THEME_ATTRIBUTE=l;exports.THEME_LAYER=h;exports.THEME_STYLE_ID=c;exports.THEME_SWITCHING_CLASS=_;exports.TOKEN_PREFIX=T;exports.applyThemeConfig=I;exports.buildThemeCss=m;exports.resolveTokens=S;exports.themeBootScript=H;exports.toStyleHtml=k;
+//# 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 { isClient } from '@handijit/utils';\n\nimport { DARK_THEME, DEFAULT_FONTS, LIGHT_THEME } from '../theme/tokens';\nimport type { UiColorScheme, UiResolvedTokens, UiThemeConfig } from '@/types/theme.type';\n\n/** CSS özel özelliği öneki — `_tokens.generated.scss` ile aynı olmak zorunda. */\nexport const TOKEN_PREFIX = '--ui-';\n\n/** Ezme kurallarını taşıyan `<style>` etiketinin kimliği. */\nexport const THEME_STYLE_ID = 'ui-theme-overrides';\n\n/** Temanın taşındığı öznitelik. `<html data-ui-theme=\"dark\">`. */\nexport const THEME_ATTRIBUTE = 'data-ui-theme';\n\n/** Bilgi yoğunluğunun taşındığı öznitelik. `<html data-ui-density=\"compact\">`. */\nexport const DENSITY_ATTRIBUTE = 'data-ui-density';\n\n/** Geçiş animasyonlarını tek kare boyunca kapatan sınıf (bkz. `base.scss`). */\nexport const THEME_SWITCHING_CLASS = 'ui-theme-switching';\n\n/** Ezmelerin katmanı — `scripts/lib/postcss-ui-layer.mjs`in varsayılanıyla aynı olmak zorunda. */\nexport const THEME_LAYER = 'ui';\n\n/**\n * Ezme kurallarının kök seçicisi: `_tokens.generated.scss`teki karşılığından bir öğe (`html`) daha\n * özgül — (0,1,1) > (0,1,0), (0,2,1) > (0,2,0). Katman içinde ezme varsayılanı KAYNAK SIRASINDAN\n * bağımsız yener. Açık temanın `html:root`u (0,1,1) koyu varsayılanın `:root:not([…])`ına\n * (0,2,0) yenilir: açık ezme koyu temaya sızmaz.\n */\nconst THEME_ROOT = 'html:root';\n\n/** Verilen şemanın tam token eşlemesi — ezmeler uygulanmış hâliyle. */\nexport const resolveTokens = (scheme: UiColorScheme, config?: UiThemeConfig): UiResolvedTokens => {\n  const base = scheme === 'dark' ? DARK_THEME : LIGHT_THEME;\n  const overrides = (scheme === 'dark' ? config?.dark : config?.light) ?? {};\n\n  return { ...base, ...overrides };\n};\n\n/**\n * Yapılandırmayı CSS metnine çevirir. Çıktının tamamı `@layer ui` içinde: tüketicinin katmansız\n * her kuralı ezmeyi özgüllükten ve sıradan bağımsız yener (README, \"CSS'imizi ezmek\").\n * ⚠ 5.6.2'ye kadar ezme katmansızdı: `:root:not([data-ui-theme])` (0,2,0) tüketicinin `<html>`e\n * yazdığı ezmeyi (`html:has(.panel)`, 0,1,1) hidrasyondan SONRA eziyordu — sunucu çiziminde\n * tüketicinin rengi, bir kare sonra temanınki (ölçüldü: panelin kırmızı sil düğmesi koyu temada\n * beyaza dönüyordu). Katmansız açık ezme koyu varsayılanı da yeniyor, koyu temaya sızıyordu.\n */\nexport const buildThemeCss = (config: UiThemeConfig): string => {\n  const blocks: string[] = [];\n\n  const declarations = (tokens: Record<string, string>, indent = '  ') =>\n    Object.entries(tokens)\n      .map(([name, value]) => `${indent}${TOKEN_PREFIX}${name}: ${value};`)\n      .join('\\n');\n\n  const fonts = config.fonts ?? {};\n  const fontEntries = Object.entries(fonts).filter(([, value]) => Boolean(value)) as [\n    keyof typeof DEFAULT_FONTS,\n    string,\n  ][];\n\n  if (fontEntries.length > 0)\n    blocks.push(\n      `${THEME_ROOT} {\\n${fontEntries\n        .map(([role, stack]) => `  ${TOKEN_PREFIX}font-${role}: ${stack};`)\n        .join('\\n')}\\n}`,\n    );\n\n  /* OLCU EZMELERI TEMA BASINA DEGIL, TEK BLOKTA. */\n  const metrics = config.metrics ?? {};\n\n  if (Object.keys(metrics).length > 0) {\n    const body = declarations(metrics as Record<string, string>);\n    blocks.push(`${THEME_ROOT} {\\n${body}\\n}`);\n    blocks.push(`${THEME_ROOT}[${DENSITY_ATTRIBUTE}='compact'] {\\n${body}\\n}`);\n  }\n\n  /*\n   * Acik tema iki secicide birden yazilir: `html:root` (varsayilan) ve\n   * `html:root[data-ui-theme='light']` (kullanicinin acik secimi).\n   */\n  if (config.light && Object.keys(config.light).length > 0) {\n    const body = declarations(config.light);\n    blocks.push(`${THEME_ROOT} {\\n${body}\\n}`);\n    blocks.push(`${THEME_ROOT}[${THEME_ATTRIBUTE}='light'] {\\n${body}\\n}`);\n  }\n\n  if (config.dark && Object.keys(config.dark).length > 0) {\n    const body = declarations(config.dark);\n    blocks.push(`${THEME_ROOT}[${THEME_ATTRIBUTE}='dark'] {\\n${body}\\n}`);\n    blocks.push(\n      `@media (prefers-color-scheme: dark) {\\n  ${THEME_ROOT}:not([${THEME_ATTRIBUTE}]) {\\n${declarations(\n        config.dark,\n        '    ',\n      )}\\n  }\\n}`,\n    );\n  }\n\n  if (blocks.length === 0) return '';\n\n  return `@layer ${THEME_LAYER} {\\n${blocks.join('\\n\\n').replace(/^(?=.)/gm, '  ')}\\n}`;\n};\n\n/**\n * `<style>` içine HTML olarak yazılacak CSS: `</style` dizisi etiketi kapatamaz. Değerler\n * yapılandırmadan (kiracının veritabanındaki marka rengi) gelebilir; `\\/` CSS'te `/` demek.\n */\nexport const toStyleHtml = (css: string): string => css.replace(/<\\/style/gi, '<\\\\/style');\n\n/**\n * Ezmeleri `<head>`in sonuna yazar — React dışındaki yol (`initUi`); sağlayıcı ezmeyi ağaçta\n * çizer.\n * ⚠ Stil sayfalarından SONRA çağrılmalı: `@layer ui` belgede ilk kez burada görülürse katman\n * sırası buradan kurulur ve tüketicinin sonra gelen `@layer reset, ui;` bildirimi `reset`i\n * `ui`nin üstüne koyar.\n */\nexport const applyThemeConfig = (config: UiThemeConfig | undefined): void => {\n  if (!isClient()) return;\n\n  const css = config ? buildThemeCss(config) : '';\n  const existing = document.getElementById(THEME_STYLE_ID);\n\n  if (css === '') {\n    existing?.remove();\n    return;\n  }\n\n  const element = existing ?? document.createElement('style');\n  element.id = THEME_STYLE_ID;\n  element.textContent = css;\n\n  if (!existing) document.head.appendChild(element);\n};\n\n/**\n * İLK BOYAMADAN ÖNCE çalışacak tema betiği — `<head>` içine, React ağacından ÖNCE.\n * Kayıtlı açık seçimi (`light` / `dark`) `<html data-ui-theme>`e yazar; kayıt yoksa öznitelik\n * yazılmaz ve sistem tercihi izlenir.\n * ⚠ React ağacına konamaz: sağlayıcı ağaç monte olduktan sonra çalışıyor ve koyu tema seçmiş\n * kullanıcı o ana kadar bir kare beyaz ekran görüyordu. İki tüketici bu betiği ELLE yazıyordu.\n * ⚠ Depolama okunamazsa (gizli pencere, engellenmiş site verisi) sessizce sistem tercihine düşer.\n * @example <script dangerouslySetInnerHTML={{ __html: themeBootScript({ storageKey: 'theme' }) }} />\n */\nexport const themeBootScript = ({ storageKey }: { storageKey: string }): string =>\n  `(function(){try{var t=localStorage.getItem(${JSON.stringify(storageKey)});` +\n  `if(t===\"light\"||t===\"dark\")document.documentElement.setAttribute(\"${THEME_ATTRIBUTE}\",t)}` +\n  `catch(e){}})()`;\n"],"names":["TOKEN_PREFIX","THEME_STYLE_ID","THEME_ATTRIBUTE","DENSITY_ATTRIBUTE","THEME_SWITCHING_CLASS","THEME_LAYER","THEME_ROOT","resolveTokens","scheme","config","base","DARK_THEME","LIGHT_THEME","overrides","buildThemeCss","blocks","declarations","tokens","indent","name","value","fonts","fontEntries","role","stack","metrics","body","toStyleHtml","css","applyThemeConfig","isClient","existing","element","themeBootScript","storageKey"],"mappings":"oJAMaA,EAAe,QAGfC,EAAiB,qBAGjBC,EAAkB,gBAGlBC,EAAoB,kBAGpBC,EAAwB,qBAGxBC,EAAc,KAQrBC,EAAa,YAGNC,EAAgB,CAACC,EAAuBC,IAA6C,CAChG,MAAMC,EAAOF,IAAW,OAASG,EAAAA,WAAaC,EAAAA,YACxCC,GAAaL,IAAW,OAASC,GAAA,YAAAA,EAAQ,KAAOA,GAAA,YAAAA,EAAQ,QAAU,CAAA,EAExE,MAAO,CAAE,GAAGC,EAAM,GAAGG,CAAA,CACvB,EAUaC,EAAiBL,GAAkC,CAC9D,MAAMM,EAAmB,CAAA,EAEnBC,EAAe,CAACC,EAAgCC,EAAS,OAC7D,OAAO,QAAQD,CAAM,EAClB,IAAI,CAAC,CAACE,EAAMC,CAAK,IAAM,GAAGF,CAAM,GAAGlB,CAAY,GAAGmB,CAAI,KAAKC,CAAK,GAAG,EACnE,KAAK;AAAA,CAAI,EAERC,EAAQZ,EAAO,OAAS,CAAA,EACxBa,EAAc,OAAO,QAAQD,CAAK,EAAE,OAAO,CAAC,EAAGD,CAAK,IAAM,EAAQA,CAAM,EAK1EE,EAAY,OAAS,GACvBP,EAAO,KACL,GAAGT,CAAU;AAAA,EAAOgB,EACjB,IAAI,CAAC,CAACC,EAAMC,CAAK,IAAM,KAAKxB,CAAY,QAAQuB,CAAI,KAAKC,CAAK,GAAG,EACjE,KAAK;AAAA,CAAI,CAAC;AAAA,EAAA,EAIjB,MAAMC,EAAUhB,EAAO,SAAW,CAAA,EAElC,GAAI,OAAO,KAAKgB,CAAO,EAAE,OAAS,EAAG,CACnC,MAAMC,EAAOV,EAAaS,CAAiC,EAC3DV,EAAO,KAAK,GAAGT,CAAU;AAAA,EAAOoB,CAAI;AAAA,EAAK,EACzCX,EAAO,KAAK,GAAGT,CAAU,IAAIH,CAAiB;AAAA,EAAkBuB,CAAI;AAAA,EAAK,CAC3E,CAMA,GAAIjB,EAAO,OAAS,OAAO,KAAKA,EAAO,KAAK,EAAE,OAAS,EAAG,CACxD,MAAMiB,EAAOV,EAAaP,EAAO,KAAK,EACtCM,EAAO,KAAK,GAAGT,CAAU;AAAA,EAAOoB,CAAI;AAAA,EAAK,EACzCX,EAAO,KAAK,GAAGT,CAAU,IAAIJ,CAAe;AAAA,EAAgBwB,CAAI;AAAA,EAAK,CACvE,CAEA,GAAIjB,EAAO,MAAQ,OAAO,KAAKA,EAAO,IAAI,EAAE,OAAS,EAAG,CACtD,MAAMiB,EAAOV,EAAaP,EAAO,IAAI,EACrCM,EAAO,KAAK,GAAGT,CAAU,IAAIJ,CAAe;AAAA,EAAewB,CAAI;AAAA,EAAK,EACpEX,EAAO,KACL;AAAA,IAA4CT,CAAU,SAASJ,CAAe;AAAA,EAASc,EACrFP,EAAO,KACP,MAAA,CACD;AAAA;AAAA,EAAA,CAEL,CAEA,OAAIM,EAAO,SAAW,EAAU,GAEzB,UAAUV,CAAW;AAAA,EAAOU,EAAO,KAAK;AAAA;AAAA,CAAM,EAAE,QAAQ,WAAY,IAAI,CAAC;AAAA,EAClF,EAMaY,EAAeC,GAAwBA,EAAI,QAAQ,aAAc,WAAW,EAS5EC,EAAoBpB,GAA4C,CAC3E,GAAI,CAACqB,EAAAA,WAAY,OAEjB,MAAMF,EAAMnB,EAASK,EAAcL,CAAM,EAAI,GACvCsB,EAAW,SAAS,eAAe9B,CAAc,EAEvD,GAAI2B,IAAQ,GAAI,CACdG,GAAA,MAAAA,EAAU,SACV,MACF,CAEA,MAAMC,EAAUD,GAAY,SAAS,cAAc,OAAO,EAC1DC,EAAQ,GAAK/B,EACb+B,EAAQ,YAAcJ,EAEjBG,GAAU,SAAS,KAAK,YAAYC,CAAO,CAClD,EAWaC,EAAkB,CAAC,CAAE,WAAAC,CAAA,IAChC,8CAA8C,KAAK,UAAUA,CAAU,CAAC,uEACHhC,CAAe"}

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

@@ -0,0 +1,49 @@
+import { UiColorScheme, UiResolvedTokens, UiThemeConfig } from '../types/theme.type';
+/** CSS özel özelliği öneki — `_tokens.generated.scss` ile aynı olmak zorunda. */
+export declare const TOKEN_PREFIX = "--ui-";
+/** Ezme kurallarını taşıyan `<style>` etiketinin kimliği. */
+export declare const THEME_STYLE_ID = "ui-theme-overrides";
+/** Temanın taşındığı öznitelik. `<html data-ui-theme="dark">`. */
+export declare const THEME_ATTRIBUTE = "data-ui-theme";
+/** Bilgi yoğunluğunun taşındığı öznitelik. `<html data-ui-density="compact">`. */
+export declare const DENSITY_ATTRIBUTE = "data-ui-density";
+/** Geçiş animasyonlarını tek kare boyunca kapatan sınıf (bkz. `base.scss`). */
+export declare const THEME_SWITCHING_CLASS = "ui-theme-switching";
+/** Ezmelerin katmanı — `scripts/lib/postcss-ui-layer.mjs`in varsayılanıyla aynı olmak zorunda. */
+export declare const THEME_LAYER = "ui";
+/** Verilen şemanın tam token eşlemesi — ezmeler uygulanmış hâliyle. */
+export declare const resolveTokens: (scheme: UiColorScheme, config?: UiThemeConfig) => UiResolvedTokens;
+/**
+ * Yapılandırmayı CSS metnine çevirir. Çıktının tamamı `@layer ui` içinde: tüketicinin katmansız
+ * her kuralı ezmeyi özgüllükten ve sıradan bağımsız yener (README, "CSS'imizi ezmek").
+ * ⚠ 5.6.2'ye kadar ezme katmansızdı: `:root:not([data-ui-theme])` (0,2,0) tüketicinin `<html>`e
+ * yazdığı ezmeyi (`html:has(.panel)`, 0,1,1) hidrasyondan SONRA eziyordu — sunucu çiziminde
+ * tüketicinin rengi, bir kare sonra temanınki (ölçüldü: panelin kırmızı sil düğmesi koyu temada
+ * beyaza dönüyordu). Katmansız açık ezme koyu varsayılanı da yeniyor, koyu temaya sızıyordu.
+ */
+export declare const buildThemeCss: (config: UiThemeConfig) => string;
+/**
+ * `<style>` içine HTML olarak yazılacak CSS: `</style` dizisi etiketi kapatamaz. Değerler
+ * yapılandırmadan (kiracının veritabanındaki marka rengi) gelebilir; `\/` CSS'te `/` demek.
+ */
+export declare const toStyleHtml: (css: string) => string;
+/**
+ * Ezmeleri `<head>`in sonuna yazar — React dışındaki yol (`initUi`); sağlayıcı ezmeyi ağaçta
+ * çizer.
+ * ⚠ Stil sayfalarından SONRA çağrılmalı: `@layer ui` belgede ilk kez burada görülürse katman
+ * sırası buradan kurulur ve tüketicinin sonra gelen `@layer reset, ui;` bildirimi `reset`i
+ * `ui`nin üstüne koyar.
+ */
+export declare const applyThemeConfig: (config: UiThemeConfig | undefined) => void;
+/**
+ * İLK BOYAMADAN ÖNCE çalışacak tema betiği — `<head>` içine, React ağacından ÖNCE.
+ * Kayıtlı açık seçimi (`light` / `dark`) `<html data-ui-theme>`e yazar; kayıt yoksa öznitelik
+ * yazılmaz ve sistem tercihi izlenir.
+ * ⚠ React ağacına konamaz: sağlayıcı ağaç monte olduktan sonra çalışıyor ve koyu tema seçmiş
+ * kullanıcı o ana kadar bir kare beyaz ekran görüyordu. İki tüketici bu betiği ELLE yazıyordu.
+ * ⚠ Depolama okunamazsa (gizli pencere, engellenmiş site verisi) sessizce sistem tercihine düşer.
+ * @example <script dangerouslySetInnerHTML={{ __html: themeBootScript({ storageKey: 'theme' }) }} />
+ */
+export declare const themeBootScript: ({ storageKey }: {
+    storageKey: string;
+}) => string;

package/build/helpers/theme.helper.js

@@ -0,0 +1,75 @@
+import { isClient as u } from "@handijit/utils";
+import { DARK_THEME as E, LIGHT_THEME as T } from "../theme/tokens.js";
+const i = "--ui-", m = "ui-theme-overrides", l = "data-ui-theme", p = "data-ui-density", H = "ui-theme-switching", y = "ui", o = "html:root", I = (t, e) => {
+  const n = t === "dark" ? E : T, r = (t === "dark" ? e == null ? void 0 : e.dark : e == null ? void 0 : e.light) ?? {};
+  return { ...n, ...r };
+}, k = (t) => {
+  const e = [], n = (s, c = "  ") => Object.entries(s).map(([h, $]) => `${c}${i}${h}: ${$};`).join(`
+`), r = t.fonts ?? {}, a = Object.entries(r).filter(([, s]) => !!s);
+  a.length > 0 && e.push(
+    `${o} {
+${a.map(([s, c]) => `  ${i}font-${s}: ${c};`).join(`
+`)}
+}`
+  );
+  const d = t.metrics ?? {};
+  if (Object.keys(d).length > 0) {
+    const s = n(d);
+    e.push(`${o} {
+${s}
+}`), e.push(`${o}[${p}='compact'] {
+${s}
+}`);
+  }
+  if (t.light && Object.keys(t.light).length > 0) {
+    const s = n(t.light);
+    e.push(`${o} {
+${s}
+}`), e.push(`${o}[${l}='light'] {
+${s}
+}`);
+  }
+  if (t.dark && Object.keys(t.dark).length > 0) {
+    const s = n(t.dark);
+    e.push(`${o}[${l}='dark'] {
+${s}
+}`), e.push(
+      `@media (prefers-color-scheme: dark) {
+  ${o}:not([${l}]) {
+${n(
+        t.dark,
+        "    "
+      )}
+  }
+}`
+    );
+  }
+  return e.length === 0 ? "" : `@layer ${y} {
+${e.join(`
+
+`).replace(/^(?=.)/gm, "  ")}
+}`;
+}, O = (t) => t.replace(/<\/style/gi, "<\\/style"), S = (t) => {
+  if (!u()) return;
+  const e = t ? k(t) : "", n = document.getElementById(m);
+  if (e === "") {
+    n == null || n.remove();
+    return;
+  }
+  const r = n ?? document.createElement("style");
+  r.id = m, r.textContent = e, n || document.head.appendChild(r);
+}, j = ({ storageKey: t }) => `(function(){try{var t=localStorage.getItem(${JSON.stringify(t)});if(t==="light"||t==="dark")document.documentElement.setAttribute("${l}",t)}catch(e){}})()`;
+export {
+  p as DENSITY_ATTRIBUTE,
+  l as THEME_ATTRIBUTE,
+  y as THEME_LAYER,
+  m as THEME_STYLE_ID,
+  H as THEME_SWITCHING_CLASS,
+  i as TOKEN_PREFIX,
+  S as applyThemeConfig,
+  k as buildThemeCss,
+  I as resolveTokens,
+  j as themeBootScript,
+  O as toStyleHtml
+};
+//# sourceMappingURL=theme.helper.js.map