@qumra/fanar 0.0.0 → 0.0.2

package/dist/index.d.ts

@@ -1,47 +1,8 @@
+import { B as ButtonVariant, a as ButtonSize, T as Tone } from './lib-DOXggTK6.js';
+export { b as TONE_SOFT, c as TONE_SOLID, d as buttonClasses, e as cn, t as toLatinDigits } from './lib-DOXggTK6.js';
 import * as react from 'react';
 import { ButtonHTMLAttributes, ReactNode, InputHTMLAttributes, SelectHTMLAttributes, TextareaHTMLAttributes, ComponentType, CSSProperties, PointerEvent, KeyboardEvent, RefObject } from 'react';
 
-/**
- * دمج كلاسات — المتأخّر بيكسب المتعارِض معه، والباقي بيفضل.
- * بيقبل أي قيمة falsy عشان `cond && 'class'` يشتغل حتى لو cond رقم أو نص.
- */
-type ClassValue = string | false | 0 | 0n | null | undefined;
-declare function cn(...parts: ClassValue[]): string;
-type Tone = 'neutral' | 'brand' | 'amber' | 'green' | 'red' | 'violet';
-declare const TONE_SOFT: Record<Tone, string>;
-declare const TONE_SOLID: Record<Tone, string>;
-/**
- * يحوّل الأرقام العربية-الهندية للاتينية.
- *
- * ── ليه ده لازم ────────────────────────────────────────────────────────
- * لوحة المفاتيح العربية على الموبايل بتكتب `٥٦٤٦`، والمتصفّح مابيعرفش
- * إنها أرقام: `Number('٥٦٤٦')` بيدّي `NaN`، و`type="number"` بيرفضها
- * ويفضّي الحقل من غير ما يقول ليه.
- *
- * فالمستخدم بيكتب رقم صح والحقل بيبان فاضي — وأسوأ حاجة في ده إنه
- * **مابيرميش خطأ**: مفيش رسالة ولا تحقّق، الرقم بيختفي وبس.
- *
- * ── والتحويل فوري ──────────────────────────────────────────────────────
- * وهو بيكتب مش عند الحفظ. لو اتأخّر للحفظ، الحقل بيفضل يعرض `٥٦٤٦`
- * والحسابات اللي بتتفرّج عليه (الربح، الإجمالي) بتشتغل على `NaN` —
- * فالشاشة بتقول رقم والحساب بيقول لأ.
- *
- * بيغطّي التلات مجموعات: العربية-الهندية (٠-٩) والفارسية-الأردية
- * (۰-۹) وعلامتَي العشرية والآلاف العربيتين.
- */
-declare function toLatinDigits(s: string): string;
-type ButtonVariant = 'primary' | 'soft' | 'outline' | 'ghost' | 'danger' | 'link';
-type ButtonSize = 'sm' | 'md' | 'lg' | 'xl';
-/**
- * كلاسات الزرار من غير العنصر نفسه.
- *
- * موجودة عشان اللينك اللي شكله زرار: `<Button>` بيطلّع `<button>`
- * دايماً، والحاجة اللي بتوَدّي لصفحة تانية لازم تبقى `<a>` — الوسط
- * بيضغط عليها يفتح تبويب، وقارئ الشاشة بيقول «رابط» مش «زر».
- * صفحة الهبوط كلها من النوع ده، فالبديل كان نسخ خرايط الأنماط.
- */
-declare function buttonClasses(variant?: ButtonVariant, size?: ButtonSize, extra?: string): string;
-
 /** سلّم الخط — الدرجة بعد `text-` */
 declare const TEXT_SCALE: readonly ["micro", "caption", "ui", "body", "lead", "base", "h4", "h3", "h2", "h1", "display", "hero", "title", "mega"];
 type TextSize = (typeof TEXT_SCALE)[number];
@@ -655,46 +616,53 @@ declare const CURRENCY: {
         decimals: number;
     };
 };
-/** صيغة الوحدة المعروضة */
-/** الصيغ الصريحة — كلٌّ منها يقول شكلاً بعينه */
+/** The displayed unit form */
+/** The explicit forms — each names one exact shape */
 type Base = 'short' | 'word' | 'code' | 'sign';
 /**
- * صيغة الوحدة المعروضة.
+ * The displayed unit form.
+ *
+ * `short` Arabic abbreviation · `word` the word · `code` the ISO code ·
+ * `sign` the graphic symbol · `best` whatever the library picks.
  *
- * `short` اختصار عربيّ · `word` الكلمة · `code` رمز ISO · `sign` الرمز
- * الرسوميّ · `best` ما تختاره المكتبة.
+ * ## `best` is an opinion, not an algorithm
  *
- * ── و`best` ليس خوارزميّة بل رأي ────────────────────────────────────────
- * لكل عملة سطر في الجدول يقول أيّ صيغة تُقرأ أسرع **لها هي**، لأن
- * الإجابة تختلف بينها:
+ * Every currency has a row in the table saying which form reads fastest **for
+ * that currency**, because the answer differs between them:
  *
- *   · الريال السعوديّ → رمزه، لأن له رمزاً رسميّاً يعرفه أهله
- *   · الجنيه والدينار والدرهم → كلمتها، فلا رمز رسميّ لها والاختصار
- *     يُقرأ حرفين قبل أن يُفهم
- *   · الدولار واليورو والإسترلينيّ → رموزها، فهي مقروءة عالميّاً
- *     وأقصر من «دولار»
+ *   - Saudi riyal → its symbol, because it has an official one its readers know
+ *   - Pound, dinar, dirham → the word, because they have no official symbol
+ *     and the abbreviation takes two characters before it means anything
+ *   - Dollar, euro, sterling → their symbols, which read worldwide and are
+ *     shorter than spelling them out
  *
- * ولو حُسبت هذه بقاعدة واحدة («رمز إن وُجد») لخرج الجنيه `£` — وهو
- * صحيح تقنيّاً ويُقرأ «إسترلينيّاً» في مصر. الرأي المكتوب لكل عملة
- * أصدق من قاعدة تبدو أنظف.
+ * Derive these from one rule ("symbol if there is one") and the Egyptian
+ * pound comes out as `£` — technically correct, and read as *sterling* in
+ * Egypt. A written opinion per currency is truer than a rule that looks
+ * tidier.
  *
- * ── وفي الإنجليزيّة ────────────────────────────────────────────────────
- * `best` يصير الرمز إن وُجد وإلّا رمز ISO — الكلمة العربية لا معنى لها
- * في صفحة إنجليزيّة، و«جنيه» لا تُكتب `pound` لأن ذلك يخلطه بالإسترلينيّ.
+ * ## In English
+ *
+ * `best` becomes the symbol where one exists and the ISO code otherwise. The
+ * Arabic word means nothing on an English page, and «جنيه» is not rendered as
+ * "pound" because that conflates it with sterling.
  */
 type SymbolStyle = Base | 'best';
 type Currency = keyof typeof CURRENCY;
 /**
- * يفحص كود عملة جاءَ من الخادم قبل تمريره إلى `Money`.
+ * Checks a currency code coming from the server before passing it to `Money`.
+ *
+ * ## Why a guard and not `as`
  *
- * ── لماذا حارس لا `as` ──────────────────────────────────────────────────
- * `Money.currency` اتّحاد مغلق، والخوادم تُرجع `string`. فكل مستهلك كان
- * يكتب `code as Currency` — وهذا **إسكات لا فحص**: كود غير معروف
- * (`XYZ`، أو حقل فارغ) يمرّ ثم يفشل عند القراءة من الجدول.
+ * `Money.currency` is a closed union and servers return `string`, so every
+ * caller was writing `code as Currency` — which **silences rather than
+ * checks**: an unknown code (`XYZ`, or an empty field) passes through and
+ * then fails at the table lookup.
  *
- * والحارس يجعل المجهول `undefined`، و`Money` عندها ترجع إلى عملة المتجر
- * من `MoneyProvider` — وهو **السلوك الصحيح**: عرض المبلغ بعملة اللوحة
- * أقلّ ضرراً من عرضه برمز خاطئ أو بلا رمز.
+ * The guard turns the unknown into `undefined`, and `Money` then falls back
+ * to the store currency from `MoneyProvider` — which is the **right**
+ * behaviour: showing the amount in the dashboard's currency does less damage
+ * than showing it with the wrong symbol, or none.
  *
  * ```tsx
  * <Money value={total} currency={isCurrency(code) ? code : undefined} />
@@ -704,19 +672,21 @@ declare function isCurrency(c?: string | null): c is Currency;
 declare function MoneyProvider({ currency, locale, children, }: {
     currency: Currency;
     /**
-     * لغة العرض على الخادم — وسم BCP-47 كامل (`ar-EG` · `ar-MA` · `en`).
+     * Display locale on the server — a full BCP-47 tag (`ar-EG` · `ar-MA` · `en`).
      *
-     * المتصفّح يقرأها من `<html lang>` وحده، فهذه للتصيير من الخادم فقط.
-     * أهملها ولن يُكسر شيء — لكن أوّل رسم سيخرج بأرقام `ar-EG` مهما كانت
-     * لغة الصفحة. الشرح عند `useMoneyLocale`.
+     * The browser reads this from `<html lang>` by itself, so this is for
+     * server rendering only. Leave it out and nothing breaks — but the first
+     * paint will use `ar-EG` digits whatever the page language is. The full
+     * explanation is on `useMoneyLocale`.
      */
     locale?: string;
     children: ReactNode;
 }): react.JSX.Element;
 /**
- * عملة المتجر الحاليّة.
+ * The current store currency.
  *
- * لغير `Money`: لاحقة حقل سعر، وعنوان عمود، ونصّ «السعر بالـ…».
+ * For everything that is not `Money`: a price field's suffix, a column
+ * header, the "priced in …" line.
  */
 declare function useCurrency(): Currency;
 declare const SIZE: {
@@ -734,79 +704,86 @@ declare const TONE: {
     readonly red: "text-red";
 };
 interface MoneyProps {
-    /** المبلغ بالوحدة الكبرى — جنيهات لا قروش */
+    /** The amount in major units — pounds, not piastres */
     value: number;
-    /** استثناء محلّي يغلب عملة المتجر — سعر بالدولار في متجر مصريّ */
+    /** A local override that beats the store currency — a dollar price in an Egyptian store */
     currency?: Currency;
     size?: keyof typeof SIZE;
     /**
-     * اللون.
+     * The colour.
      *
-     * الافتراضيّ يرث لون ما حوله — والسالب **لا يُلوَّن تلقائياً**.
-     * خصم في شلّال ومرتجَع في قائمة كلاهما سالب، والأول محايد والثاني
-     * يستحقّ الأحمر. الفرق يعرفه السياق لا المكوّن.
+     * The default inherits from its surroundings — and a negative is **not
+     * coloured automatically**. A deduction in a waterfall and a refund in a
+     * list are both negative; the first is neutral and the second earns red.
+     * Context knows the difference, the component does not.
      */
     tone?: keyof typeof TONE;
-    /** يُظهر `+` على الموجب — للفروق لا للأرصدة */
+    /** Shows `+` on positives — for deltas, not balances */
     signed?: boolean;
-    /** «٧١٫٤ ألف» بدل «٧١٬٤٠٠» — للكروت والرسوم */
+    /** "71.4K" instead of "71,400" — for stat cards and charts */
     compact?: boolean;
     /**
-     * يُخفي الكسور حين تكون أصفاراً.
+     * Hides the decimals when they are zeros.
      *
-     * قائمة أسعار كلّها `٫٠٠` تضيف ضجيجاً بلا معلومة. لكن **الفاتورة
-     * لا تُخفيه**: المبلغ الرسميّ يُكتب كاملاً.
+     * A price list that is all `.00` adds noise and no information. But **an
+     * invoice does not hide them**: a formal amount is written in full.
      */
     trimZeros?: boolean;
-    /** السعر قبل الخصم — يُشطب ويوضع بعد الحالي */
+    /** The price before the discount — struck through, placed after the current one */
     was?: number;
     /**
-     * صيغة الوحدة.
+     * The unit form.
      *
-     * `short` الاختصار العربيّ (افتراضيّ) · `code` رمز ISO للفاتورة
-     * والتصدير · `sign` الرمز الرسوميّ حيث يوجد ويحمله الخطّ.
+     * `short` the Arabic abbreviation (default) · `code` the ISO code for
+     * invoices and exports · `sign` the graphic symbol where one exists and the
+     * font carries it.
      *
-     * و`sign` يرجع إلى `short` تلقائياً للعملة التي لا رمز لها في الخطّ
-     * — والقائمة في أعلى الملفّ تقول أيّها.
+     * `sign` falls back to `short` automatically for any currency whose symbol
+     * is not in the font — the table at the top of this file says which.
      *
-     * والافتراضيّ يتبع لغة الصفحة: `short` في العربية و`code` في
-     * الإنجليزية — «ج.م» لا تُقرأ لمن لا يقرأ العربية.
+     * The default follows the page language: `short` in Arabic and `code` in
+     * English — «ج.م» means nothing to someone who does not read Arabic.
      */
     symbol?: SymbolStyle;
-    /** يُخفي الوحدة — لعمود جدول عنوانه يحملها */
+    /** Hides the unit — for a table column whose header already carries it */
     hideSymbol?: boolean;
     className?: string;
 }
 /**
- * مبلغ.
+ * An amount of money.
  *
- * ── لماذا مكوّن لا دالة تنسيق ──────────────────────────────────────────
- * الدالة تُرجع نصّاً، والنصّ يفقد ثلاثة أشياء يحتاجها المبلغ: العزل
- * الاتجاهيّ حول الرقم، ومنع القطع بين الرقم وعملته، وأرقام بعرض ثابت
- * تصطفّ في العمود. كلّها خصائص عرض لا صياغة — فمكانها عنصر.
+ * ## Why a component and not a format function
+ *
+ * A function returns a string, and a string loses three things an amount
+ * needs: directional isolation around the number, a guarantee the number and
+ * its currency never break across lines, and fixed-width digits that line up
+ * in a column. All three are presentation, not formatting — so they belong to
+ * an element.
  */
 declare function Money({ value, currency, size, tone, signed, compact, trimZeros, was, symbol, hideSymbol, className, }: MoneyProps): react.JSX.Element;
 /**
- * وحدة العملة وحدها — لعنوان عمود أو لاحقة حقل.
+ * The currency unit on its own — for a column header or a field suffix.
  *
- * نفس الرجوع: `sign` غير الموجود في الخطّ يعود إلى `short`، فما يظهر
- * في عنوان العمود يطابق ما يظهر في صفوفه دائماً.
+ * Same fallback: a `sign` the font does not carry returns `short`, so what
+ * appears in the column header always matches what appears in its rows.
  */
 /**
- * وحدة العملة وحدها — لعنوان عمود أو لاحقة حقل.
+ * The currency unit on its own — for a column header or a field suffix.
  *
- * ترجع `ReactNode` لا نصّاً: وحدة الريال في صيغة `word` **رسم** لأن
- * رمزه الرسميّ هو كلمة «ريال» نفسها. من يحتاج نصّاً خالصاً — عنوان
- * ملفّ مُصدَّر مثلاً — يطلب `code`.
+ * Returns a `ReactNode` rather than a string: the riyal's unit in `word` form
+ * is **drawn**, because its official symbol is the word "riyal" itself.
+ * Anyone who needs plain text — the header of an exported file, say — should
+ * ask for `code`.
  */
 declare function currencySymbol(c?: Currency, style?: SymbolStyle, locale?: string): ReactNode;
-/** الاسم المنطوق — لقارئ الشاشة وللقوائم المنسدلة */
+/** The spoken name — for screen readers and select menus */
 declare const currencyName: (c?: Currency) => string;
 /**
- * وحدة العملة تابعةً للغة الصفحة — لعنوان عمود يحمل عملة صفوفه.
+ * The currency unit following the page language — for a column header that
+ * carries its rows' currency.
  *
- * `currencySymbol` الساكنة لا تعرف اللغة، فعنوان العمود كان يظلّ «ج.م»
- * فوق صفوف مكتوبة `EGP`.
+ * The static `currencySymbol` does not know the language, so a column header
+ * stayed as «ج.م» above rows written `EGP`.
  */
 declare function useCurrencySymbol(c?: Currency, style?: SymbolStyle): ReactNode;
 
@@ -2362,811 +2339,4 @@ declare function Skeleton({ variant, width, className, }: {
     className?: string;
 }): react.JSX.Element;
 
-/**
- * إصدار الصيغة.
- *
- * بيتحطّ في كل رسالة عشان المستقبِل يعرف يقرأها. الرسالة بلا `v`
- * بتتقري على إنها `1` — الرسايل القديمة اتبعتت قبل ما الحقل يوجد.
- */
-declare const NOTIFICATION_SCHEMA_VERSION = 1;
-/**
- * أولوية الإشعار — تلات درجات، كل واحدة ليها سلوك.
- *
- *   `low`       بيوصل صامت
- *   `normal`    الافتراضي
- *   `critical`  بيرنّ أعلى ٣٥٪، ومابيتعلّمش مقروء بـ«تعليم الكل»،
- *               وبيتعدّ في `needsAction`
- *
- * ── وكانت أربعة ─────────────────────────────────────────────────────────
- * `high` كانت موجودة في نوع الاتحاد وبس — مافيش سطر واحد بيقراها.
- * أربع درجات وواحدة فيهم مالهاش أثر أوحش من تلاتة كلهم شغّالين: اللي
- * بيختار بيقعد يفكّر في فرق مش موجود، واللي بيقرا الكود بيدوّر على
- * سلوك مش هيلاقيه.
- *
- * الرسالة اللي لسه بتبعت `high` بتتقرا `normal` بتحذير — مش برفض.
- */
-type NotificationPriority = 'low' | 'normal' | 'critical';
-declare const NOTIFICATION_PRIORITIES: NotificationPriority[];
-/**
- * الإجراء — وجهة لا دالة.
- *
- * `href` مسار داخلي (`/orders/1052`) أو رابط كامل. المكتبة مابتنقّلش
- * بنفسها: بتنادي `onAction` واللي بيستخدمها بيوصّله براوتره. كده نفس
- * الرسالة بتشتغل في تطبيق React Router وتطبيق Next وصفحة ساكنة.
- */
-interface NotificationAction {
-    label: string;
-    href: string;
-}
-/**
- * الرسالة على السلك — ده اللي السيرفر بيبعته وقاعدة البيانات بتخزّنه.
- *
- * كل الحقول الاختيارية ليها افتراضي في `parseNotification`، فالسيرفر
- * بيبعت أقل حاجة والباقي بيتحسب.
- *
- * @example
- * {
- *   "v": 1,
- *   "id": "ntf_01HZY8K3",
- *   "kind": "order.created",
- *   "at": "2026-08-10T14:32:00.000Z",
- *   "title": "طلب جديد #1052",
- *   "body": "مدفوع بالكامل، وفي انتظار التجهيز.",
- *   "priority": "normal",
- *   "data": { "orderId": "1052", "total": 1480, "currency": "EGP" },
- *   "action": { "label": "افتح الطلب", "href": "/orders/1052" }
- * }
- */
-interface NotificationJSON {
-    /** إصدار الصيغة — غيابه بيتقري `1` */
-    v?: number;
-    /** معرّف فريد وثابت. التكرار بيتلغي بيه، فلازم يكون من السيرفر */
-    id: string;
-    /** اسم الحدث `domain.event` — `order.created`, `stock.depleted` */
-    kind: string;
-    /** ISO 8601 بتوقيت UTC — `2026-08-10T14:32:00.000Z` */
-    at: string;
-    title: string;
-    body?: string;
-    /**
-     * وقت القراية بالـISO — `null` أو غياب يعني غير مقروء.
-     *
-     * ── ليه وقت مش بوليان ───────────────────────────────────────────────
-     * `read: true` أحادي: مفيش طريقة تقول «رجّعه غير مقروء»، ولو عملتها
-     * أول مزامنة بتقلبها تاني — لأن القاعدة «المقروء بيكسب» مالهاش
-     * مرجع تقارن بيه.
-     *
-     * الوقت بيدّي نفس الضمانة (الأحدث بيكسب) وبيفتح تلاتة كمان:
-     * «غير مقروء» بيبقى حدث أحدث، والتراجع بيعرف علامته من علامة جهاز
-     * تاني وصلت في نفس اللحظة، و«الوقت لحد القراية» بيتحسب مجاناً.
-     */
-    readAt?: string | null;
-    /** @deprecated استخدم `readAt` — بتتقرا وبتتحوّل، وهتتشال */
-    read?: boolean;
-    priority?: NotificationPriority;
-    /**
-     * مفتاح تجميع — بيلمّ **الكروت الطايرة وبس**.
-     *
-     * الرسالة الجديدة بتحلّ محلّ اللي قبلها من نفس المجموعة في طابور
-     * الكروت. تلات كروت من نفس المصدر بتنزل مع بعض هي الضجيج اللي
-     * بيخلّي التاجر يطفّي الإشعارات.
-     *
-     * ── والصندوق مابيلمّش ──────────────────────────────────────────────
-     * التلاتة بيفضلوا سطور منفصلة. الكرت بيقاطع فبيستاهل اللمّ؛ السطر
-     * بيتقري بمهلة فاللمّ فيه بيخفي معلومة.
-     *
-     * واللمّ الدائم («٣ مواضيع جديدة» كسطر واحد) شغل السيرفر: هو اللي
-     * شايف النافذة الزمنية كلها. اللمّ على العميل بيلمّ اللي وصل
-     * للتبويب ده بس — والكروت مالهاش المشكلة دي لأنها لكل تبويب أصلاً
-     * وبتعيش تواني ومحدّش بيعدّها.
-     */
-    group?: string;
-    /** حمولة الحدث — المكتبة مابتقراهاش، بتمرّرها للي بيستخدمها */
-    data?: Record<string, unknown>;
-    action?: NotificationAction;
-    /**
-     * تسكيت رسالة واحدة — `'none'` وبس.
-     *
-     * الأصل إن الصوت من النوع في السجلّ. ده للاستثناء: نفس النوع بيوصل
-     * صامت في استيراد بالجملة مثلاً. مفيش قيمة تانية — النغمة مش
-     * قابلة للتبديل من الرسالة.
-     */
-    sound?: 'none';
-}
-/**
- * الرسالة بعد التحقّق — دي اللي المكوّنات بتشتغل عليها.
- *
- * الفرق عن `NotificationJSON`: التاريخ بقى `Date`، والاختياري اتملى
- * بافتراضياته. فمفيش مكوّن بيعمل `?? 'normal'` ولا `new Date(...)`
- * تاني — التطبيع بيحصل مرّة على الحدود.
- */
-interface Notification {
-    v: number;
-    id: string;
-    kind: string;
-    at: Date;
-    title: string;
-    body?: string;
-    /** وقت القراية — `null` يعني غير مقروء */
-    readAt: Date | null;
-    /** اختصار لـ`readAt !== null` — محسوب، مش مخزّن */
-    read: boolean;
-    priority: NotificationPriority;
-    group?: string;
-    data: Record<string, unknown>;
-    action?: NotificationAction;
-    sound?: 'none';
-}
-/**
- * دالة الترجمة — من نظام المشروع، مش من المكتبة.
- *
- * ── ليه المكتبة مابتترجمش بنفسها ────────────────────────────────────────
- * أول تنفيذ كان `locale.startsWith('ar') ? '…' : '…'` جوّه السجلّ. ده
- * بيمشي لنوعين وبيقع عند التاني عشر:
- *
- *   · النصوص بتبقى مدفونة في كود، فالمترجم مايقدرش يلمسها
- *   · المثنّى والجمع العربي (طلب · طلبين · ٣ طلبات) مستحيل بـ`startsWith`
- *   · ولو المشروع عنده نظام ترجمة، ده بيعمل نظام تاني جنبه
- *
- * فالمكتبة بتملك **نقطة التعليق** مش الترجمة: بتنادي `t` بمفتاح وقيم،
- * و`t` بتيجي من `NotificationProvider`. النصوص بتفضل في الكتالوج،
- * والجمع شغل النظام المتخصّص فيه، والمكتبة تفضل مش عارفة لغة إيه —
- * زي ما هي مش عارفة `order.created` يعني إيه.
- */
-type NotificationTranslate = (key: string, vars?: Record<string, unknown>) => ReactNode;
-/**
- * صوت النوع — نغمة واحدة أو سكوت.
- *
- * `notify` هي نغمة الإشعارات الوحيدة، مضمّنة كـdata URI في `chime.ts`
- * فمفيش ملف يتنسخ ولا مسار يتكسر لما المكتبة تتنقل لمشروع تاني.
- * و`none` بتسكّت النوع كله — للي بيتقرا ومابيستاهلش مقاطعة.
- *
- * والنغمة نفسها **مش قابلة للتبديل**: هي جزء من هوية قمرة زي اللون
- * والخط. اللي المشروع بيقرّره هو أنهي نوع يرنّ وأنهي نوع يعدّي صامت.
- */
-type NotificationSoundName = 'notify' | 'none';
-/**
- * تعريف نوع إشعار — الربط بين اسم الحدث وشكله وصوته.
- *
- * ده اللي بيخلّي النظام ينفع لأكتر من مشروع: المكتبة مابتعرفش
- * `order.created` يعني إيه، بتعرف تقرا السجلّ. والمشروع بيسجّل
- * أنواعه هو.
- */
-interface NotificationKind {
-    /** اسم الحدث زي ما بيجي من السيرفر — `order.created` */
-    kind: string;
-    /** اسم مقروء — بيظهر في إعدادات الإشعارات والفلترة */
-    label: string;
-    icon: ComponentType<{
-        size?: number;
-        strokeWidth?: number;
-    }>;
-    /**
-     * نغمة الحالة — والافتراضي محايد عن قصد.
-     *
-     * دي بتقول «الحاجة دي مقلقة» مش «دي من قسم الطلبات». لو كل نوع خد
-     * لون، الصندوق بيبقى قوس قزح والعاجل بيتوّه فيه.
-     */
-    tone?: Tone;
-    /** أولوية النوع لو الرسالة ما حدّدتش */
-    priority?: NotificationPriority;
-    /**
-     * النوع ده يرنّ ولا لأ — الافتراضي `notify`.
-     *
-     * ده القرار الوحيد المتاح في الصوت، وهو قرار منتج مش هوية:
-     * «تحديث تطبيق» مايستاهلش مقاطعة، «فشل تحصيل» يستاهل. النغمة
-     * نفسها والعلوّ والإيقاع ثوابت في المكتبة.
-     */
-    sound?: NotificationSoundName;
-    /**
-     * بناء العنوان من `data` بدل نصّ السيرفر — **اختياري**.
-     *
-     * ── المشكلة اللي بيحلّها ────────────────────────────────────────────
-     * `title` بيتخزّن باللغة اللي كانت وقت الإرسال. التاجر بيبدّل اللغة،
-     * وبيلاقي إشعارات الشهر اللي فات لسه بالقديمة. ده بيحصل في قمرة
-     * فعلاً — التطبيقات عربي وإنجليزي.
-     *
-     * ── وليه اختياري مش الافتراضي ───────────────────────────────────────
-     * لو كل الأنواع بترسم على العميل، تصليح صياغة أو غلطة إملائية بيبقى
-     * محتاج **نشر فرونت**. دلوقتي ده تعديل على السيرفر بيوصل فورًا.
-     * فالنوع اللي عنده قالب بيترجم، واللي مالوش بياخد نصّ السيرفر —
-     * وتتبنّاها نوع نوع للي يستاهل.
-     *
-     * والنوع المش مسجّل بيفضل شغّال بنصّ السيرفر، فالباك إند ينشر نوع
-     * جديد من غير ما يستنّى الفرونت.
-     *
-     * ── والقالب بينادي `t` مابيترجمش ────────────────────────────────────
-     * المفتاح والقيم بس. النصّ في كتالوج مشروعك، والجمع والتشكيل شغل
-     * نظام الترجمة عندك.
-     *
-     * ولو المشروع ما مرّرش `t` للمزوّد، القالب **بيتجاهل** ونصّ السيرفر
-     * بيتعرض — أأمن من مفتاح خام قدّام التاجر.
-     *
-     * @example
-     * {
-     *   kind: 'order.created',
-     *   title: (n, t) => t('notif.order.created', { id: n.data.orderId }),
-     * }
-     */
-    title?: (n: Notification, t: NotificationTranslate) => ReactNode;
-    /** نفس فكرة `title` للنصّ التحته */
-    body?: (n: Notification, t: NotificationTranslate) => ReactNode;
-}
-/**
- * النوع بعد الحلّ — الشكل والصوت مضمونين، والقوالب لأ.
- *
- * غياب `title`/`body` **معنى** مش نقص: يعني «خد نصّ السيرفر». فمفيش
- * افتراضي يتحطّ لهم، ولو اتحطّ كان هيدوس على نصّ جاي من السيرفر بنصّ
- * فاضي.
- */
-interface ResolvedKind extends Required<Omit<NotificationKind, 'title' | 'body'>> {
-    title?: NotificationKind['title'];
-    body?: NotificationKind['body'];
-    /** النوع ده مش مسجّل، والقيم دي من الاحتياطي */
-    unknown: boolean;
-}
-interface NotificationKindRegistry {
-    /** بيرجّع النوع، ولو مش مسجّل بيرجّع الاحتياطي بـ`unknown: true` */
-    get: (kind: string) => ResolvedKind;
-    /** كل الأنواع المسجّلة — لشاشة إعدادات الإشعارات */
-    list: () => ResolvedKind[];
-    has: (kind: string) => boolean;
-}
-
-type NotificationParseResult = {
-    ok: true;
-    value: Notification;
-    warnings: string[];
-} | {
-    ok: false;
-    issues: string[];
-};
-interface NotificationBatch {
-    items: Notification[];
-    /** اللي اتعزل — الرسالة الخام وسبب الرفض، عشان يتسجّل مش يتبلع */
-    rejected: {
-        raw: unknown;
-        issues: string[];
-    }[];
-    /** تحذيرات على رسايل عدّت — حقل اتجاهل، إصدار أحدث */
-    warnings: string[];
-}
-/**
- * بيحقّق رسالة واحدة ويطبّعها.
- *
- * المطلوب: `id` و`kind` و`at` و`title`. الباقي بياخد افتراضي.
- * `at` لازم يكون تاريخ ISO مقروء — الرقم أو النص المكسور بيترفض، لأن
- * `Invalid Date` بيعدّي صامت وبيطلع «NaN من كذا دقيقة» في الواجهة.
- */
-interface ParseOptions {
-    /**
-     * سجلّ الأنواع — منه بييجي افتراضي الأولوية لما الرسالة ما تحدّدش.
-     *
-     * من غيره الرسالة اللي مافيهاش `priority` بتاخد `normal` مهما كان
-     * نوعها — يعني `payment.failed` المسجّل `critical` بيوصل عادي،
-     * والسجلّ بيبقى زينة. وده بيكسر أساس النظام: المكتبة مابتعرفش
-     * `order.created` يعني إيه، بتعرف تقرا السجلّ.
-     */
-    kinds?: NotificationKindRegistry;
-}
-declare function parseNotification(raw: unknown, options?: ParseOptions): NotificationParseResult;
-/**
- * بيحقّق دفعة ويعزل الوحش.
- *
- * بيقبل مصفوفة، أو نص JSON، أو كائن فيه `items`/`notifications` —
- * التلات أشكال اللي الـAPIs بتبعت بيهم. وبيرتّب بالأحدث، وبيلغّي
- * تكرار الـ`id` (آخر نسخة بتكسب: التحديث بيوصل بنفس المعرّف).
- */
-declare function parseNotifications(raw: unknown, options?: ParseOptions): NotificationBatch;
-/**
- * بيرجّع الرسالة لصيغتها على السلك — للتخزين أو إعادة الإرسال.
- *
- * عكس `parseNotification` بالظبط: `parse(serialize(n))` بيدّي `n`.
- * لازم يفضل كده، وإلا الرسالة اللي اتخزّنت مابترجعش زي ما دخلت.
- */
-declare function serializeNotification(n: Notification): NotificationJSON;
-
-/**
- * بينشئ سجلّ أنواع.
- *
- * @param kinds الأنواع المسجّلة
- * @param fallback تجاوز الشكل الاحتياطي للنوع المش معروف
- *
- * @example
- * const KINDS = createKindRegistry([
- *   { kind: 'ticket.assigned', label: 'تذكرة', icon: Ticket, priority: 'critical' },
- * ])
- * KINDS.get('ticket.assigned').icon      // Ticket
- * KINDS.get('حاجة.غريبة').unknown        // true
- */
-declare function createKindRegistry(kinds: NotificationKind[], fallback?: Partial<Omit<ResolvedKind, 'kind' | 'unknown'>>): NotificationKindRegistry;
-/**
- * أنواع التجارة الإلكترونية — طقم جاهز لمنتجات قمرة.
- *
- * ده **مثال مسجّل** مش جزء من العقد. المشروع التاني بيبني سجلّه
- * بـ`createKindRegistry` ومابياخدش الطقم ده.
- *
- * ── واللون هنا استثناء مش قاعدة ─────────────────────────────────────────
- * أربعة بس من اتناشر ليهم نغمة: فشل الدفع والمخزون الخالص والطلب
- * المتعثّر والمرتجع. الباقي محايد. لو كل نوع خد لونه، مافيش حاجة
- * بتتشاف قبل حاجة — واللون بيبطّل يعني حالة.
- *
- * ── و`critical` تلاتة بس ────────────────────────────────────────────────
- * القاعدة: نزيف **مستمرّ لحد ما حد يتصرّف**. فشل التحصيل والمخزون
- * الخالص والطلب المتعثّر بيكلّفوا كل يوم بيعدّي؛ المرتجع حصل وخلاص.
- * والفرق مش أكاديمي: `critical` مابتتمسحش بـ«تعليم الكل»، فلو اتوسّعت
- * الحماية بتبقى ضجيج مالوش مفتاح إطفاء.
- *
- * ── والقوالب على اتنين بس ───────────────────────────────────────────────
- * `order.created` و`payout.sent` عندهم قالب بينادي `t` بمفتاح وقيم،
- * فبيترجموا من كتالوج المشروع. الباقي بياخد نصّ السيرفر — عشان تصليح
- * صياغة يفضل تعديل سيرفر بيوصل فورًا مش نشر فرونت.
- *
- * ومن غير `t` على المزوّد، القوالب بتتجاهل والكل بياخد نصّ السيرفر.
- *
- * ── والصوت واحد أو ولا حاجة ─────────────────────────────────────────────
- * النغمة نفسها لكل نوع بيستاهل مقاطعة، و`none` للي بيتقرا ومابيستاهلش:
- * تحديث تطبيق وملخّص المجتمع. نغمات متعدّدة بتفترض إن التاجر هيحفظ
- * إن النازلة يعني دفع فشل — وده مابيحصلش، بيسمع رنّة فبيبصّ.
- * والإلحاح بيتقال بالعلوّ: `critical` بتعلى ٣٥٪.
- */
-declare const QUMRA_KINDS: NotificationKind[];
-/** سجلّ قمرة جاهز — `QUMRA_NOTIFICATIONS.get('order.created')` */
-declare const QUMRA_NOTIFICATIONS: NotificationKindRegistry;
-
-/** الصوت الوحيد في المكتبة — `none` بتسكّت النوع */
-declare const NOTIFICATION_SOUNDS: Exclude<NotificationSoundName, 'none'>[];
-interface UseNotificationSoundOptions {
-    /** سجلّ الأنواع — منه بييجي صوت كل نوع (`notify` أو `none`) */
-    kinds: NotificationKindRegistry;
-}
-interface NotificationSoundApi {
-    /** الصوت اتفكّ وجاهز — قبلها أي `play` بتتبلع */
-    ready: boolean;
-    muted: boolean;
-    setMuted: (muted: boolean) => void;
-    /**
-     * بيفكّ الصوت — **لازم من معالج حدث مستخدم حقيقي**.
-     *
-     * بتتنادى لوحدها على أول ضغطة لو `autoUnlock`. النداء اليدوي لزرار
-     * «شغّل الصوت» في الإعدادات.
-     */
-    unlock: () => Promise<boolean>;
-    /** بيرنّ حسب النوع — بيحترم الكتم والحدّ الأدنى والأولوية */
-    play: (n: Notification) => void;
-    /** بيرنّ حالاً — لزرار «جرّب الصوت» في الإعدادات */
-    preview: () => void;
-}
-declare function useNotificationSound({ kinds }: UseNotificationSoundOptions): NotificationSoundApi;
-
-interface NotificationsApi {
-    /** كل الرسايل، الأحدث الأول */
-    items: Notification[];
-    /** عدد غير المقروء — ده اللي الجرس بيعرضه */
-    unread: number;
-    /**
-     * غير المقروء اللي «تعليم الكل» مش بيمسحه — الحرج.
-     *
-     * مفصول عن `unread` عن قصد: بعد «تعليم الكل» العدّاد بينزل لكن
-     * مش لصفر، وده بيتقرا عطل لو مافيش رقم تاني بيفسّره. والفصل بيسمح
-     * بوزن بصري مختلف — نقطة حمرا مابتروحش أبداً بترجّع نفس الضغط
-     * اللي بيخلّي التاجر يطفّي الإشعارات.
-     */
-    needsAction: number;
-    /** الوارد لسه — اللي الكروت الطايرة بتعرضه */
-    arrivals: Notification[];
-    /** المرفوض من آخر `hydrate`/`receive` — للتسجيل مش للعرض */
-    rejected: NotificationBatch['rejected'];
-    /**
-     * بيحمّل الموجود من قبل — **صامت وإضافي**.
-     *
-     * بيضيف ويحدّث ومابيشيلش. ده نداء أول تحميل، وتحميل صفحة تانية،
-     * وأي دفعة قديمة.
-     */
-    hydrate: (raw: unknown) => NotificationBatch;
-    /**
-     * مزامنة — **صامتة وبتشيل**.
-     *
-     * زي `hydrate` بس بتشيل كمان اللي السيرفر مابعتوش، **جوّه المدى
-     * الزمني اللي الدفعة بتغطّيه وبس**. فمزامنة الصفحة الأولى مابتمسحش
-     * الصفحات اللي تحتها.
-     */
-    sync: (raw: unknown) => NotificationBatch;
-    /**
-     * بيستقبل وارد جديد — بيرنّ وبيطلع طاير.
-     *
-     * بياخد رسالة واحدة أو دفعة. الرسالة المرفوضة بتتعزل ومابتوقّعش
-     * الباقي.
-     */
-    receive: (raw: unknown) => NotificationBatch;
-    /**
-     * إشعار محلّي من غير سيرفر — بيملى `id` و`at` و`v` لوحده.
-     *
-     * للأفعال اللي التطبيق بيعرف نتيجتها فوراً. بيعدّي على نفس
-     * التحقّق، فالمحلّي مابياخدش طريق جانبي.
-     */
-    push: (input: Omit<NotificationJSON, 'id' | 'at' | 'v'> & {
-        id?: string;
-        at?: string;
-    }) => string | null;
-    markRead: (id: string) => void;
-    markAllRead: () => void;
-    /**
-     * رجّعهم غير مقروئين — للتراجع، ولزرار «علّمه كغير مقروء».
-     *
-     * فعل باسمه زي باقي الـAPI (`dismiss` · `markAllRead` · `sync`)
-     * بدل `setRead(ids, false)`: العلَم البوليان بيخلّي مكان النداء
-     * يحتاج قراية التوقيع عشان يتفهم.
-     */
-    markUnread: (ids: string[]) => void;
-    /** بيلغي شاهد الشيل وبيرجّع الرسالة — للتراجع لما السيرفر يرفض */
-    restore: (n: Notification) => void;
-    /**
-     * السيرفر أكّد الشيل — الشاهد مابقاش لازم.
-     *
-     * من غيرها الشاهد بيستنّى انتهاء صلاحيته على الفاضي، والمجموعة
-     * بتكبر مع كل شيل في الجلسة.
-     */
-    confirmDismiss: (id: string) => void;
-    dismiss: (id: string) => void;
-    clearArrival: (id: string) => void;
-    clearAllArrivals: () => void;
-}
-interface UseNotificationsOptions {
-    /**
-     * سجلّ الأنواع — منه بييجي افتراضي الأولوية.
-     *
-     * من غيره أي رسالة مافيهاش `priority` بتاخد `normal`، فالنوع
-     * المسجّل `critical` بيوصل عادي و`needsAction` بتعدّ غلط.
-     */
-    kinds?: NotificationKindRegistry;
-    /** رسايل أولية — بتتحمّل صامتة زي `hydrate` */
-    initial?: unknown;
-    /** بيتنادى لكل وارد جديد اتقبل — ده مكان الصوت */
-    onReceive?: (n: Notification) => void;
-    /** بيتنادى لما رسالة تترفض — سجّلها، متبلعهاش */
-    onReject?: (rejected: NotificationBatch['rejected']) => void;
-}
-/** `critical` مابيتعلّمش مقروء بـ«تعليم الكل» — «شفته» مش «عالجته» */
-declare const isBulkReadable: (n: Notification) => boolean;
-declare function useNotifications({ kinds, initial, onReceive, onReject, }?: UseNotificationsOptions): NotificationsApi;
-
-/**
- * تحديث تفاؤلي بتراجع.
- *
- * الواجهة بتتغيّر فوراً، والمزامنة بتجري. لو فشلت، `undo` بترجّع
- * الحالة و`onError` بيقول للمستخدم — لأن التراجع الصامت أوحش من
- * الفشل نفسه: العدّاد بيرجع يطلع والمستخدم مايعرفش ليه.
- *
- * `run` ممكن يرجّع `void` أو وعد، وممكن يرمي متزامن. التلات حالات
- * بتتعامل واحد — المستدعي اللي مابيزامنش مابيدفعش تمن، واللي
- * بيزامن مابيحتاجش يلفّ نداءه في `try`.
- */
-declare function optimistic(run: (() => void | Promise<void>) | undefined, undo: () => void, onError?: (error: unknown) => void): void;
-interface UseNotificationCenterOptions extends UseNotificationsOptions {
-    /** سجلّ الأنواع — بيروح للصوت وبيترجّع عشان يتحطّ في المزوّد */
-    kinds: NotificationKindRegistry;
-    /**
-     * اتقرا إشعار — بالفتح أو بـ«تعليم كمقروء».
-     *
-     * ده مكان المزامنة مع السيرفر. العلامة بتتحطّ **قبل** النداء
-     * (تفاؤلياً) عشان الواجهة ما تستناش الشبكة.
-     *
-     * ── ولو السيرفر رفض ─────────────────────────────────────────────────
-     * ارمي أو رجّع وعداً بيترفض، والمكتبة بترجّع العلامة لوحدها. من
-     * غير كده الواجهة بتوعد بحاجة السيرفر مانفّذهاش: التاجر بيشوف
-     * العدّاد وقع، وبيفتح من جهاز تاني فيلاقيه زي ما هو.
-     *
-     * @example
-     * onRead: async (n) => { await api.markRead(n.id) }   // الفشل بيرجّع العلامة
-     */
-    onRead?: (n: Notification) => void | Promise<void>;
-    /** اتقرا الكل — نداء واحد بدل نداء لكل رسالة. الفشل بيرجّع الكل */
-    onReadAll?: (ids: string[]) => void | Promise<void>;
-    /** اتشال من الصندوق. الفشل بيرجّع الرسالة لمكانها */
-    onDismiss?: (n: Notification) => void | Promise<void>;
-    /**
-     * فشلت مزامنة مع السيرفر واتراجعنا — اعرض توست هنا.
-     *
-     * التراجع الصامت أوحش من الفشل نفسه: العدّاد بيرجع يطلع والمستخدم
-     * مايعرفش ليه.
-     *
-     * و`items` جوّه السياق عشان الرسالة تبقى مفيدة: «تعذّر حفظ قراية»
-     * بتسأل «قراية إيه؟»، و«تعذّر حفظ قراية ٣ إشعارات» بترد.
-     */
-    onSyncError?: (error: unknown, context: {
-        action: 'read' | 'readAll' | 'dismiss';
-        items: Notification[];
-    }) => void;
-    /**
-     * اتضغط إجراء الإشعار — الوجهة في `n.action.href`.
-     *
-     * وصّلها براوترك. الإشعار بيتعلّم مقروء لوحده قبل النداء.
-     */
-    onOpen?: (n: Notification) => void;
-}
-interface NotificationCenter extends NotificationsApi {
-    sound: NotificationSoundApi;
-    /** نفس السجلّ اللي دخل — عشان `NotificationProvider` ياخده من مصدر واحد */
-    kinds: NotificationKindRegistry;
-    /**
-     * الخصائص الجاهزة للمزوّد والأسطح — بتوصّل الفتح والقراءة لوحدها.
-     *
-     * `<NotificationProvider {...inbox.bind.provider}>` بدل ما تكتب
-     * `onAction` و`onOpen` في كل سطح.
-     */
-    bind: {
-        provider: {
-            kinds: NotificationKindRegistry;
-            onAction: (n: Notification) => void;
-        };
-        surface: {
-            items: Notification[];
-            unread: number;
-            needsAction: number;
-            sound: NotificationSoundApi;
-            onMarkAllRead: () => void;
-            onDismiss: (id: string) => void;
-            onOpen: (n: Notification) => void;
-        };
-    };
-}
-/**
- * الحالة والصوت موصولين — نداء واحد.
- *
- * @example
- * const inbox = useNotificationCenter({
- *   kinds: QUMRA_NOTIFICATIONS,
- *   initial: await api.notifications(),   // بيتحمّل صامت
- * })
- *
- * <NotificationProvider kinds={inbox.kinds} onAction={(n) => navigate(n.action.href)}>
- *   <NotificationMenu unread={inbox.unread} items={inbox.items} sound={inbox.sound} … />
- *   <NotificationToastHost items={inbox.arrivals} onClose={inbox.clearArrival} />
- * </NotificationProvider>
- *
- * // والوارد من السوكت — بيرنّ وبيطلع طاير
- * socket.on('notification', inbox.receive)
- */
-declare function useNotificationCenter({ kinds, onReceive, onRead, onReadAll, onDismiss, onOpen, onSyncError, ...rest }: UseNotificationCenterOptions): NotificationCenter;
-
-/**
- * الوقت النسبي — «من دقيقتين»، «إمبارح»، «من ٣ شهور».
- *
- * أقل من نصّ دقيقة بيتقري «الآن» بدل «قبل ٣٠ ثانية»: الفرق مالوش
- * معنى للقارئ، والرقم اللي بيتغيّر كل ثانية بيسحب العين. والنصّ من
- * `Intl` — فبيشتغل على أي لغة من غير ما المكتبة تعرفها.
- *
- * @param at وقت الإشعار
- * @param locale اللغة — الافتراضي `ar`
- * @param now لحقن الوقت في الاختبار
- */
-declare function formatRelativeTime(at: Date, locale?: string, now?: Date): string;
-/**
- * كل كام يجب إعادة الرسم عشان النصّ يفضل صح.
- *
- * «من دقيقة» بيبقى غلط بعد دقيقة، و«من ٣ شهور» بيفضل صح لأسبوع.
- * المؤقّت بيتظبط على دقّة الوحدة بدل ما يشتغل كل ثانية على قايمة
- * فيها أربعين سطر.
- */
-declare function relativeTickMs(at: Date, now?: Date): number;
-
-interface NotificationContext {
-    kinds: NotificationKindRegistry;
-    locale: string;
-    t?: NotificationTranslate;
-    onAction?: (n: Notification) => void;
-}
-interface NotificationProviderProps {
-    /** سجلّ الأنواع — الافتراضي سجلّ قمرة */
-    kinds?: NotificationKindRegistry;
-    /** لغة الوقت النسبي — الافتراضي `ar` */
-    locale?: string;
-    /**
-     * دالة الترجمة من نظام مشروعك — لقوالب عناوين الأنواع.
-     *
-     * من غيرها القوالب بتتجاهل ونصّ السيرفر بيتعرض. المكتبة مابتترجمش
-     * بنفسها: بتنادي `t(key, vars)` وبس، فالنصوص بتفضل في كتالوجك
-     * والجمع شغل نظامك.
-     */
-    t?: NotificationTranslate;
-    /**
-     * التنقّل لوجهة الإشعار.
-     *
-     * المكتبة مابتنقّلش بنفسها لأن الرسالة بتحمل `href` مش دالة.
-     * خدها من `n.action.href` ووصّلها لراوترك.
-     */
-    onAction?: (n: Notification) => void;
-    children: ReactNode;
-}
-/** بيوزّع السجلّ واللغة والتنقّل على كل الأسطح — مرّة في الجذر */
-declare function NotificationProvider({ kinds, locale, t, onAction, children, }: NotificationProviderProps): react.JSX.Element;
-declare const useNotificationContext: () => NotificationContext;
-interface NotificationBellProps {
-    unread: number;
-    /**
-     * منهم كام محتاج إجراء — بيغيّر **شكل** العدّاد مش رقمه.
-     *
-     * نقطة حمرا مابتروحش أبداً بترجّع نفس الضغط اللي بيخلّي التاجر
-     * يطفّي الإشعارات. فالعدّاد بيفضل رقم غير المقروء، والحرج بيتعلّم
-     * بحلقة حواليه — علامة تانية على نفس الرقم مش رقم تاني.
-     */
-    needsAction?: number;
-    onClick: () => void;
-    /** بيوصل لـ`aria-expanded` — الجرس اللي بيفتح لوح لازم يقولها */
-    expanded?: boolean;
-    label?: string;
-    /** «٣ غير مقروءة» — الرقم في `aria-label` مش في الشكل وحده */
-    unreadLabel?: (n: number) => string;
-    className?: string;
-}
-/**
- * زرّ الجرس بعدّاد غير المقروء.
- *
- * العدّاد أحمر ومحاط بحلقة من لون الخلفية — من غيرها الرقم بيتلزق في
- * أي أيقونة وراه وبيتقرا جزء منها. والرقم في `aria-label` كمان: قارئ
- * الشاشة مابيشوفش الشارة، وجرس بيقول «الإشعارات» وبس بيخلّي اللي بيسمع
- * يفتح الصندوق كل مرة عشان يعرف فيه جديد ولا لأ.
- */
-declare function NotificationBell({ unread, needsAction, onClick, expanded, label, unreadLabel, className, }: NotificationBellProps): react.JSX.Element;
-interface NotificationRowProps {
-    item: Notification;
-    /** بيتنادى بعد فتح الوجهة — علّمه مقروء هنا */
-    onOpen?: (n: Notification) => void;
-    onDismiss?: (id: string) => void;
-    dismissLabel?: string;
-    unreadLabel?: string;
-}
-/**
- * سطر إشعار واحد.
- *
- * غير المقروء بيتعلّم بحاجتين: نقطة وخطّ أتقل. اللون وحده مابيكفيش —
- * واحد من كل اتني عشر راجل مابيفرّقش بين درجتين رماديين صغيّرين،
- * والوزن بيتقرا بالعين مهما كان.
- *
- * والسطر **مش زرار كله**. الصندوق فيه سطور بتفتح وسطور بتتقري وبس،
- * ولو السطر كله قابل للضغط اللي عايز يقرا بيدوس بالغلط ويلاقي نفسه في
- * صفحة تانية. الإجراء زرار له اسم.
- */
-declare function NotificationRow({ item, onOpen, onDismiss, dismissLabel, unreadLabel, }: NotificationRowProps): react.JSX.Element;
-interface NotificationListProps {
-    items: Notification[];
-    onOpen?: (n: Notification) => void;
-    onDismiss?: (id: string) => void;
-    emptyTitle?: ReactNode;
-    emptyDescription?: ReactNode;
-    className?: string;
-}
-/** القايمة نفسها — نفسها في اللوح المنسدل وفي الدرج الجانبي بالظبط */
-declare function NotificationList({ items, onOpen, onDismiss, emptyTitle, emptyDescription, className, }: NotificationListProps): react.JSX.Element;
-interface NotificationPanelProps extends NotificationListProps {
-    title?: ReactNode;
-    unread?: number;
-    /**
-     * غير المقروء اللي «تعليم الكل» مش بيمسحه.
-     *
-     * لازم يتعرض: العدّاد بينزل من ١٢ لـ٢ وبيقف، واللي مايعرفش ليه
-     * بيدوس تاني ومافيش، فبيتقرا عطل. السطر بيقول السبب مرّة واحدة.
-     */
-    needsAction?: number;
-    onMarkAllRead?: () => void;
-    markAllLabel?: string;
-    /** تذييل «عرض الكل» — من غيره الصندوق بيبقى نهاية الطريق */
-    onViewAll?: () => void;
-    viewAllLabel?: string;
-    /** زرّ كتم الصوت في الترويسة — مرّره من `useNotificationSound` */
-    sound?: {
-        muted: boolean;
-        setMuted: (m: boolean) => void;
-        ready: boolean;
-    };
-}
-/**
- * اللوح المنسدل — صندوق الإشعارات جنب الجرس.
- *
- * ارتفاع القايمة محدود و**بيتمرّر جوّه**: اللوح اللي بيطول بطول القايمة
- * بيوصل لآخر الشاشة وبيقص آخر إشعار من غير ما يبان إنه مقصوص.
- *
- * و«تعليم الكل كمقروء» بيختفي لما يبقى مفيش غير مقروء — زرار بيعمل لا
- * حاجة موجود دايماً بيعلّم المستخدم إن الأزرار هنا مش بترد.
- */
-declare function NotificationPanel({ items, title, unread, needsAction, onMarkAllRead, markAllLabel, onViewAll, viewAllLabel, sound, onOpen, onDismiss, emptyTitle, emptyDescription, className, }: NotificationPanelProps): react.JSX.Element;
-interface SoundToggleProps {
-    muted: boolean;
-    setMuted: (m: boolean) => void;
-    /** الصوت اتفكّ — قبلها الزرار بيقول إنه مقفول من المتصفّح مش من المستخدم */
-    ready: boolean;
-    className?: string;
-}
-/**
- * كتم صوت الإشعارات.
- *
- * الحالة التالتة مهمة: **مش مكتوم بس المتصفّح لسه قافل**. الزرار
- * بيقولها بدل ما يدّعي إن الصوت شغّال — والمستخدم اللي مستني رنّة
- * مش جاية يستاهل يعرف السبب.
- */
-declare function SoundToggle({ muted, setMuted, ready, className }: SoundToggleProps): react.JSX.Element;
-interface NotificationMenuProps extends Omit<NotificationPanelProps, 'unread'> {
-    unread: number;
-    bellLabel?: string;
-    /**
-     * الحافة اللي اللوح بيتحاذى عليها مع الجرس — الافتراضي `end`.
-     *
-     * الجرس في الشريط العلوي بيبقى ناحية `end`، فاللوح بيتمدّد ناحية
-     * `start` وبيفضل جوّه الشاشة. لو الجرس اتحرّك لازم ده يتقلب.
-     */
-    align?: 'start' | 'end';
-    /**
-     * فوق الجرس ولا تحته — الافتراضي `bottom`.
-     *
-     * الشريط السفلي على الموبايل محتاج `top`: لوح بينزل من جرس على آخر
-     * الشاشة بيطلع كله برّه.
-     */
-    side?: 'top' | 'bottom';
-    className?: string;
-}
-/**
- * الجرس واللوح كوحدة — ده اللي الشريط العلوي بيحطّه.
- *
- * الإغلاق بالضغط برّه وبـEscape. والاتنين لازمين: الضغط برّه هو
- * المتوقّع بالفأرة، وEscape هو المخرج الوحيد للي ماسك كيبورد.
- */
-declare function NotificationMenu({ unread, bellLabel, align, side, className, onViewAll, onOpen, ...panel }: NotificationMenuProps): react.JSX.Element;
-interface NotificationDrawerProps extends NotificationListProps {
-    open: boolean;
-    onClose: () => void;
-    title?: ReactNode;
-    unread?: number;
-    /** زي `NotificationPanel` — الشرح لازم يبان على الموبايل كمان */
-    needsAction?: number;
-    onMarkAllRead?: () => void;
-    markAllLabel?: string;
-    closeLabel?: string;
-}
-/**
- * الدرج الجانبي — نفس الصندوق لكن من حافة الشاشة.
- *
- * ليه التنين مش واحد: اللوح المنسدل معلّق في الجرس، وعلى شاشة ٣٦٠
- * بكسل ده يعني لوح بيغطّي الشاشة وطرفه بره الحافة. والدرج بيفتح من
- * `inline-end` — الشمال في العربي واليمين في الإنجليزي، لوحده.
- *
- * والقايمة جوّاه **هي هي** بلا فرق حرف: اللي شاف إشعاراً على الديسكتوب
- * وبصّ له على الموبايل لازم يشوف نفس السطر، وإلا بيفتكرهم اتنين.
- */
-declare function NotificationDrawer({ open, onClose, items, title, unread, needsAction, onMarkAllRead, markAllLabel, closeLabel, onOpen, onDismiss, emptyTitle, emptyDescription, }: NotificationDrawerProps): react.JSX.Element;
-/**
- * ركن الشاشة اللي الطاير بينزل فيه.
- *
- * `start`/`end` منطقية مش يمين وشمال: `end` يعني الشمال في العربي
- * واليمين في الإنجليزي. الجرس بيقلب مكانه مع اللغة، والإشعار لازم
- * يقلب معاه — وإلا بيجي من ناحية وبيتخزّن في ناحية تانية.
- */
-type NotificationPlacement = 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end';
-interface NotificationToastHostProps {
-    items: Notification[];
-    onClose: (id: string) => void;
-    onOpen?: (n: Notification) => void;
-    /**
-     * الركن — الافتراضي `top-end` عشان يقع جنب الجرس.
-     *
-     * وخلّيه بعيد عن ركن `ToastHost` (`bottom-start` افتراضاً): التوست
-     * بيقول «الفعل اللي عملته حصل» والإشعار بيقول «حاجة جت من برّه»،
-     * ولو الاتنين طلعوا من نفس المكان بيتقروا طابور واحد.
-     */
-    placement?: NotificationPlacement;
-    /** عرض العمود فوق `sm` — تحتها بياخد العرض كله */
-    width?: string;
-    closeLabel?: string;
-    regionLabel?: string;
-    className?: string;
-}
-/**
- * الإشعار الطاير — الكرت اللي بينزل لما حاجة توصل.
- *
- * `aria-live="polite"` مش `assertive`: الأخير بيقطع قارئ الشاشة في
- * نصّ الجملة. الإشعار مقاطعة أصلاً، مايستاهلش يقاطع مرتين — اللي بيقرا
- * هيسمعه لما يخلّص السطر.
- */
-declare function NotificationToastHost({ items, onClose, onOpen, placement, width, closeLabel, regionLabel, className, }: NotificationToastHostProps): react.JSX.Element | null;
-
-export { ANIMATE_SCALE, Accordion, type AccordionItem, Alert, type Animation, type AudioLevel, AudioPlayer, type AudioPlayerProps, Avatar, type AvatarSize, Badge, type BadgeProps, BarChart, type BarSeries, BrowserFrame, type BrowserFrameProps, Button, type ButtonProps, type ButtonSize, type ButtonVariant, COLOR_SCALE, CONTAINER_SCALE, Card, CardHeader, Carousel, type CarouselProps, type Chapter, Checkbox, ChoiceCards, type ChoiceOption, type ChoiceProps, Coach, type CoachApi, type CoachAudio, type CoachHint, type CoachItem, type CoachLine, type CoachOrb, CoachProvider, type CoachProviderProps, type CoachRegion, type CoachWhen, type CoachWhere, ColorField, type ColorToken, type Column, Combobox, type CommandItem, CommandPalette, type Container, Counter, type Currency, DARK_TOKENS, DataTable, type DataTableProps, DateRangePicker, Drawer, Dropdown, Dropzone, EmptyState, type FieldSize, FileRow, type FilterChip, FilterChips, FunnelChart, type FunnelStage, Gallery, type GalleryImage, type GalleryProps, GoalBar, Heatmap, Input, type InputProps, Lightbox, type LightboxProps, LocaleCtx, type MediaState, Modal, Money, type MoneyProps, MoneyProvider, MultiSelect, NOTIFICATION_PRIORITIES, NOTIFICATION_SCHEMA_VERSION, NOTIFICATION_SOUNDS, type Notification, type NotificationAction, type NotificationBatch, NotificationBell, type NotificationBellProps, type NotificationCenter, NotificationDrawer, type NotificationDrawerProps, type NotificationJSON, type NotificationKind, type NotificationKindRegistry, NotificationList, type NotificationListProps, NotificationMenu, type NotificationMenuProps, NotificationPanel, type NotificationPanelProps, type NotificationParseResult, type NotificationPlacement, type NotificationPriority, NotificationProvider, type NotificationProviderProps, NotificationRow, type NotificationRowProps, type NotificationSoundApi, type NotificationSoundName, NotificationToastHost, type NotificationToastHostProps, type NotificationTranslate, type NotificationsApi, NumberStepper, type NumberStepperProps, type Option, PROVIDER_LEVEL_LABEL, PROVIDER_LEVEL_LABEL_EN, PageHeader, ParetoChart, type ParetoItem, type ParseOptions, Phone, type PhoneFormat, type PhoneParts, type PhoneProps, Product3DViewer, type Product3DViewerProps, Progress, ProviderBadge, type ProviderBadgeProps, type ProviderBadgeSize, type ProviderLevel, ProviderMark, type ProviderMarkProps, QUMRA_KINDS, QUMRA_NOTIFICATIONS, RADIUS_SCALE, Radio, RadioGroup, type Radius, type Range, RatingInput, type RatingInputProps, type ResolvedKind, type RunwayItem, SHADOW_SCALE, Scrubber, SearchInput, Select, type SelectProps, type Shadow, type ShareItem, ShareList, Sheet, Skeleton, type SortableApi, type SortableItemProps, SortableStatus, SoundToggle, type SoundToggleProps, Sparkline, Stars, type StarsProps, StatCard, type StatCardProps, Stepper, type StepperStep, StockRunway, Switch, type SymbolStyle, TEXT_SCALE, TOKENS, TONE_SOFT, TONE_SOLID, type TabItem, Tabs, TechnicalInput, type TechnicalInputProps, type TechnicalKind, TechnicalText, type TextSize, Textarea, type TextareaProps, Timeline, type TimelineStep, Toast, ToastHost, type ToastInput, type ToastItem, type ToastTone, type TokenName, type Tone, Tooltip, TrendChart, type UITextKey, type UploadFile, type UploadState, type UseNotificationCenterOptions, type UseNotificationSoundOptions, type UseNotificationsOptions, type UseSortableOptions, VerifiedBadge, type VerifiedBadgeProps, VideoPlayer, type VideoPlayerProps, type VideoSuggestion, WaterfallChart, type WaterfallStep, WhatsAppIcon, buttonClasses, cn, coachSeconds, createKindRegistry, currencyName, currencySymbol, daysBetween, formatBytes, formatDate, formatRange, formatRelativeTime, formatTime, isBulkReadable, isCurrency, normalizeHex, optimistic, parseNotification, parseNotifications, parsePhone, presets, relativeTickMs, serializeNotification, toLatinDigits, useAudioLevel, useCoach, useCoachOptional, useCurrency, useCurrencySymbol, useMedia, useMoneyLang, useMoneyLocale, useNotificationCenter, useNotificationContext, useNotificationSound, useNotifications, useSortable, useToasts, useUIText };
+export { ANIMATE_SCALE, Accordion, type AccordionItem, Alert, type Animation, type AudioLevel, AudioPlayer, type AudioPlayerProps, Avatar, type AvatarSize, Badge, type BadgeProps, BarChart, type BarSeries, BrowserFrame, type BrowserFrameProps, Button, type ButtonProps, ButtonSize, ButtonVariant, COLOR_SCALE, CONTAINER_SCALE, Card, CardHeader, Carousel, type CarouselProps, type Chapter, Checkbox, ChoiceCards, type ChoiceOption, type ChoiceProps, Coach, type CoachApi, type CoachAudio, type CoachHint, type CoachItem, type CoachLine, type CoachOrb, CoachProvider, type CoachProviderProps, type CoachRegion, type CoachWhen, type CoachWhere, ColorField, type ColorToken, type Column, Combobox, type CommandItem, CommandPalette, type Container, Counter, type Currency, DARK_TOKENS, DataTable, type DataTableProps, DateRangePicker, Drawer, Dropdown, Dropzone, EmptyState, type FieldSize, FileRow, type FilterChip, FilterChips, FunnelChart, type FunnelStage, Gallery, type GalleryImage, type GalleryProps, GoalBar, Heatmap, Input, type InputProps, Lightbox, type LightboxProps, LocaleCtx, type MediaState, Modal, Money, type MoneyProps, MoneyProvider, MultiSelect, NumberStepper, type NumberStepperProps, type Option, PROVIDER_LEVEL_LABEL, PROVIDER_LEVEL_LABEL_EN, PageHeader, ParetoChart, type ParetoItem, Phone, type PhoneFormat, type PhoneParts, type PhoneProps, Product3DViewer, type Product3DViewerProps, Progress, ProviderBadge, type ProviderBadgeProps, type ProviderBadgeSize, type ProviderLevel, ProviderMark, type ProviderMarkProps, RADIUS_SCALE, Radio, RadioGroup, type Radius, type Range, RatingInput, type RatingInputProps, type RunwayItem, SHADOW_SCALE, Scrubber, SearchInput, Select, type SelectProps, type Shadow, type ShareItem, ShareList, Sheet, Skeleton, type SortableApi, type SortableItemProps, SortableStatus, Sparkline, Stars, type StarsProps, StatCard, type StatCardProps, Stepper, type StepperStep, StockRunway, Switch, type SymbolStyle, TEXT_SCALE, TOKENS, type TabItem, Tabs, TechnicalInput, type TechnicalInputProps, type TechnicalKind, TechnicalText, type TextSize, Textarea, type TextareaProps, Timeline, type TimelineStep, Toast, ToastHost, type ToastInput, type ToastItem, type ToastTone, type TokenName, Tone, Tooltip, TrendChart, type UITextKey, type UploadFile, type UploadState, type UseSortableOptions, VerifiedBadge, type VerifiedBadgeProps, VideoPlayer, type VideoPlayerProps, type VideoSuggestion, WaterfallChart, type WaterfallStep, WhatsAppIcon, coachSeconds, currencyName, currencySymbol, daysBetween, formatBytes, formatDate, formatRange, formatTime, isCurrency, normalizeHex, parsePhone, presets, useAudioLevel, useCoach, useCoachOptional, useCurrency, useCurrencySymbol, useMedia, useMoneyLang, useMoneyLocale, useSortable, useToasts, useUIText };