@kashi-ui/elements 0.25.0 → 1.0.0

package/README.md

@@ -26,11 +26,21 @@ import "@kashi-ui/css";
 import "@kashi-ui/elements";
 ```
 
+## زبان انگلیسی
+
+```ts
+import { setLocale } from "@kashi-ui/elements";
+setLocale("en"); // پیش از ساخته شدن عنصرها
+```
+
+راهنما: https://kashi.sepantapouya.com/docs/i18n/
+
 ## عنصرها
 
 - **فیلدهای فارسی:** `kashi-national-id`، `kashi-legal-id`، `kashi-mobile`، `kashi-landline`، `kashi-card-number`، `kashi-iban`، `kashi-postal-code`، `kashi-price`
+- **فیلد متنی و اطلاعیه:** `kashi-input` (پاک کردن، نمایش رمز، شمارنده)، `kashi-textarea`، `kashi-banner` (با دکمهٔ بستن)
 - **فیلدهای دیگر:** `kashi-time-input`، `kashi-plate-input`، `kashi-persian-textarea`، `kashi-keyboard-fix`، `kashi-password-strength`، `kashi-inline-edit`
-- **انتخاب:** `kashi-date-picker`، `kashi-calendar`، `kashi-date-range-picker`، `kashi-month-picker`، `kashi-otp`، `kashi-combobox`، `kashi-multi-select`، `kashi-province-select`، `kashi-city-select`، `kashi-tag-input`، `kashi-chip-group`، `kashi-number-input`، `kashi-slider`، `kashi-rating`، `kashi-color-picker`، `kashi-file-upload`
+- **انتخاب:** `kashi-date-picker`، `kashi-calendar`، `kashi-date-range-picker`، `kashi-month-picker`، `kashi-appointment-picker`، `kashi-otp`، `kashi-combobox`، `kashi-multi-select`، `kashi-province-select`، `kashi-city-select`، `kashi-tag-input`، `kashi-chip-group`، `kashi-number-input`، `kashi-slider`، `kashi-rating`، `kashi-color-picker`، `kashi-file-upload`
 - **نشانی و نقشه:** `kashi-address-form`، `kashi-iran-map`
 - **داده و نمودار:** `kashi-data-table`، `kashi-pagination`، `kashi-bar-chart`، `kashi-line-chart`، `kashi-pie-chart`، `kashi-bar-list`، `kashi-proportion-bar`، `kashi-sparkline`، `kashi-activity-heatmap`
 - **نمایش:** `kashi-money`، `kashi-date`، `kashi-relative-time`، `kashi-countdown`

package/dist/appointment.d.ts

@@ -0,0 +1,40 @@
+import { HTMLBase } from "./base.js";
+export interface AppointmentSlot {
+    time: string;
+    available?: boolean;
+}
+/**
+ * انتخاب نوبت: روزهای شمسی در یک ردیف (با تعداد نوبت خالی) و ساعت‌های همان روز در گروه‌های صبح، بعدازظهر و عصر.
+ * ساعت کاری با from، to و step؛ نوبت‌های پر با booked (JSON) یا همهٔ ساعت‌ها با element.getSlots.
+ * با name دو فیلد name_date (YYYY-MM-DD) و name_time در فرم ارسال می‌شوند.
+ */
+export declare class KashiAppointmentPicker extends HTMLBase {
+    static observedAttributes: string[];
+    /** ساعت‌های هر روز به‌طور کامل: (date) => ["09:00", { time: "09:30", available: false }] */
+    getSlots?: (date: Date) => (string | AppointmentSlot)[];
+    /** روزهای تعطیل دلخواه؛ پیش‌فرض جمعه‌ها و تعطیلات رسمی ثابت */
+    isClosed?: (date: Date) => boolean;
+    private selected;
+    private active;
+    private valueSet;
+    private rendered;
+    private timer;
+    private key;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, old: string | null, next: string | null): void;
+    /** «2026-11-04 10:30» */
+    private parse;
+    /** نوبت انتخاب‌شده: { date, time } */
+    get value(): {
+        date: Date;
+        time: string;
+    } | null;
+    set value(v: {
+        date: Date;
+        time: string;
+    } | null);
+    private list;
+    private render;
+    private roving;
+}

package/dist/appointment.js

@@ -0,0 +1,175 @@
+import { formatJalali, formatTime, fromISODate, getIranHoliday, parseTime, toFaDigits, toISODate, toJalali } from "@kashi-ui/persian";
+import { calendarNames, define, digitsOf, emit, esc, HTMLBase, lang, msg, uid } from "./base.js";
+const PERIODS = [["morning", 12], ["afternoon", 17], ["evening", 24]];
+const day = (d, add = 0) => new Date(d.getFullYear(), d.getMonth(), d.getDate() + add);
+const same = (a, b) => a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();
+const minutes = (t) => {
+    const p = parseTime(t);
+    return p ? p.hours * 60 + p.minutes : 0;
+};
+const CLOCK = '<svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="10" cy="10" r="7"/><path d="M10 6v4l2.5 2"/></svg>';
+/**
+ * انتخاب نوبت: روزهای شمسی در یک ردیف (با تعداد نوبت خالی) و ساعت‌های همان روز در گروه‌های صبح، بعدازظهر و عصر.
+ * ساعت کاری با from، to و step؛ نوبت‌های پر با booked (JSON) یا همهٔ ساعت‌ها با element.getSlots.
+ * با name دو فیلد name_date (YYYY-MM-DD) و name_time در فرم ارسال می‌شوند.
+ */
+export class KashiAppointmentPicker extends HTMLBase {
+    constructor() {
+        super(...arguments);
+        this.selected = null;
+        this.active = -1;
+        this.valueSet = false;
+        this.rendered = false;
+        this.key = uid("kashi-appt");
+    }
+    connectedCallback() {
+        if (!this.rendered && !this.valueSet)
+            this.selected = this.parse(this.getAttribute("value"));
+        this.render();
+        // ساعت‌های گذشتهٔ امروز هر دقیقه پر می‌شوند
+        clearInterval(this.timer);
+        this.timer = setInterval(() => !this.contains(document.activeElement) && this.render(), 60000);
+    }
+    disconnectedCallback() {
+        clearInterval(this.timer);
+    }
+    attributeChangedCallback(name, old, next) {
+        if (!this.rendered || old === next)
+            return;
+        if (name === "value")
+            this.selected = this.parse(next);
+        this.render();
+    }
+    /** «2026-11-04 10:30» */
+    parse(v) {
+        const m = (v ?? "").trim().match(/^(\d{4}-\d{2}-\d{2})[ T](\d{1,2}:\d{2})$/);
+        const d = m ? fromISODate(m[1]) : null;
+        return d && m ? { date: d, time: formatTime(parseTime(m[2])) } : null;
+    }
+    /** نوبت انتخاب‌شده: { date, time } */
+    get value() {
+        return this.selected ? { ...this.selected } : null;
+    }
+    set value(v) {
+        this.valueSet = true;
+        this.selected = v ? { date: day(v.date), time: v.time } : null;
+        if (this.rendered)
+            this.render();
+    }
+    list() {
+        const now = new Date();
+        const start = fromISODate(this.getAttribute("start") ?? "") ?? now;
+        const count = Math.max(1, Number(this.getAttribute("days")) || 7);
+        let booked = {};
+        try {
+            booked = JSON.parse(this.getAttribute("booked") ?? "{}");
+        }
+        catch { /* قالب نادرست نادیده گرفته می‌شود */ }
+        const from = this.getAttribute("from") ?? "09:00", to = this.getAttribute("to") ?? "17:00";
+        const step = Number(this.getAttribute("step")) || 30;
+        const closedAttr = this.getAttribute("closed") !== "false";
+        return Array.from({ length: count }, (_, i) => {
+            const d = day(start, i);
+            const closed = this.isClosed ? this.isClosed(d) : closedAttr && !!getIranHoliday(d, { locale: lang() });
+            let slots = [];
+            if (!closed) {
+                if (this.getSlots)
+                    slots = this.getSlots(d).map((s) => (typeof s === "string" ? { time: s, available: true } : { time: s.time, available: s.available ?? true }));
+                else {
+                    const taken = new Set(booked[toISODate(d)] ?? []);
+                    for (let m = minutes(from); m + step <= minutes(to); m += step) {
+                        const time = formatTime({ hours: Math.floor(m / 60), minutes: m % 60 });
+                        slots.push({ time, available: !taken.has(time) });
+                    }
+                }
+                if (same(d, now)) {
+                    const nm = now.getHours() * 60 + now.getMinutes();
+                    slots = slots.map((s) => (minutes(s.time) <= nm ? { ...s, available: false } : s));
+                }
+            }
+            return { date: d, closed, slots, free: slots.filter((s) => s.available).length };
+        });
+    }
+    render(focus = null) {
+        const now = new Date();
+        const fa = digitsOf(this) === "fa";
+        const n = (v) => (fa ? toFaDigits(String(v)) : String(v));
+        const digits = fa ? "fa" : "latin";
+        const list = this.list();
+        if (this.active < 0 || this.active >= list.length) {
+            const i = this.selected ? list.findIndex((x) => same(x.date, this.selected.date)) : -1;
+            this.active = i >= 0 ? i : Math.max(0, list.findIndex((x) => x.free > 0));
+        }
+        const cur = list[this.active];
+        const M = msg(), A = M.appointment, { months, weekdays } = calendarNames(), locale = lang();
+        const label = this.getAttribute("label") ?? A.label;
+        const wd = (d) => (same(d, now) ? M.common.today : same(d, day(now, 1)) ? M.common.tomorrow : weekdays[(d.getDay() + 1) % 7]);
+        const daysHtml = list.map((x, i) => {
+            const { jm, jd } = toJalali(x.date);
+            const status = x.closed ? A.closed : x.free ? A.freeLong(n(x.free)) : A.none;
+            return `<button type="button" role="radio" data-i="${i}" class="k-appt__day" aria-checked="${i === this.active}" tabindex="${i === this.active ? 0 : -1}"${x.closed ? " disabled" : ""} aria-label="${esc(`${formatJalali(x.date, { style: "full", digits, locale })}${M.common.list}${status}`)}"><span class="k-appt__weekday" aria-hidden="true">${wd(x.date)}</span><span class="k-appt__date" aria-hidden="true">${n(jd)}</span><span class="k-appt__month" aria-hidden="true">${months[jm - 1]}</span><span class="k-appt__free" aria-hidden="true">${x.closed ? A.closed : x.free ? A.free(n(x.free)) : A.full}</span></button>`;
+        }).join("");
+        const selDay = !!this.selected && same(this.selected.date, cur.date);
+        const focusTime = selDay ? this.selected.time : cur.slots.find((s) => s.available)?.time;
+        const slotsHtml = cur.closed || !cur.free
+            ? `<p class="k-appt__empty">${cur.closed ? A.closedDay : A.noSlots}</p>`
+            : PERIODS.map(([title, until], k) => {
+                const slots = cur.slots.filter((s) => minutes(s.time) / 60 < until && minutes(s.time) / 60 >= (k ? PERIODS[k - 1][1] : 0));
+                if (!slots.length)
+                    return "";
+                const gid = `${this.key}-p${k}`;
+                return `<div class="k-appt__group"><p class="k-appt__period" id="${gid}">${A[title]}</p><div class="k-appt__times" role="radiogroup" aria-labelledby="${gid}">${slots.map((s) => `<button type="button" role="radio" class="k-appt__time" data-time="${s.time}" aria-checked="${selDay && this.selected.time === s.time}" tabindex="${s.time === focusTime ? 0 : -1}"${s.available ? "" : " disabled"} aria-label="${esc(A.time(n(s.time)))}${s.available ? "" : esc(A.booked)}">${n(s.time)}</button>`).join("")}</div></div>`;
+            }).join("");
+        const name = this.getAttribute("name");
+        const sel = this.selected;
+        this.innerHTML = `<div class="k-appt" role="group" aria-labelledby="${this.key}-label"><p class="k-label" id="${this.key}-label" style="margin: 0">${esc(label)}</p><div class="k-appt__days" role="radiogroup" aria-label="${esc(A.day)}">${daysHtml}</div><div class="k-appt__slots">${slotsHtml}</div><p class="k-appt__summary" aria-live="polite">${sel ? `${CLOCK}<span>${esc(A.yours)} <strong>${esc(A.at(formatJalali(sel.date, { style: "full", digits, locale }), n(sel.time)))}</strong></span>` : ""}</p>${name ? `<input type="hidden" name="${esc(`${name}_date`)}" value="${sel ? toISODate(sel.date) : ""}"><input type="hidden" name="${esc(`${name}_time`)}" value="${sel?.time ?? ""}">` : ""}</div>`;
+        this.rendered = true;
+        const days = this.querySelector(".k-appt__days");
+        const times = this.querySelector(".k-appt__slots");
+        days.addEventListener("click", (e) => {
+            const b = e.target.closest(".k-appt__day");
+            if (!b || b.disabled)
+                return;
+            this.active = Number(b.dataset.i);
+            this.render("day");
+        });
+        times.addEventListener("click", (e) => {
+            const b = e.target.closest(".k-appt__time");
+            if (!b || b.disabled)
+                return;
+            this.selected = { date: cur.date, time: b.dataset.time };
+            this.render("time");
+            emit(this, "kashi-change", { date: toISODate(cur.date), time: this.selected.time, value: this.value });
+        });
+        days.addEventListener("keydown", (e) => this.roving(e, days, (b) => {
+            this.active = Number(b.dataset.i);
+            this.render("day");
+        }));
+        times.addEventListener("keydown", (e) => this.roving(e, times));
+        if (focus === "day")
+            days.querySelector('[tabindex="0"]')?.focus();
+        if (focus === "time")
+            times.querySelector('[aria-checked="true"]')?.focus();
+        if (focus === "day")
+            days.querySelector('[tabindex="0"]')?.scrollIntoView?.({ block: "nearest", inline: "nearest" });
+    }
+    // فوکوس گردشی؛ در RTL فلش چپ یعنی بعدی
+    roving(e, box, onMove) {
+        const items = [...box.querySelectorAll('[role="radio"]:not(:disabled)')];
+        const i = items.indexOf(document.activeElement);
+        if (i < 0)
+            return;
+        const rtl = getComputedStyle(box).direction === "rtl";
+        const step = { ArrowLeft: rtl ? 1 : -1, ArrowRight: rtl ? -1 : 1, ArrowDown: 1, ArrowUp: -1 }[e.key];
+        const to = step ? (i + step + items.length) % items.length : e.key === "Home" ? 0 : e.key === "End" ? items.length - 1 : -1;
+        if (to < 0)
+            return;
+        e.preventDefault();
+        if (onMove)
+            onMove(items[to]);
+        else
+            items[to].focus();
+    }
+}
+KashiAppointmentPicker.observedAttributes = ["start", "days", "from", "to", "step", "booked", "closed", "label", "name", "digits", "value"];
+define("kashi-appointment-picker", KashiAppointmentPicker, "block");

package/dist/base.d.ts

@@ -1,3 +1,4 @@
+import { type KashiLocale, type KashiMessagesInput } from "@kashi-ui/persian";
 /** در Node.js (رندر سمت سرور) HTMLElement وجود ندارد؛ import کردن پکیج نباید خطا بدهد */
 export declare const HTMLBase: typeof HTMLElement;
 /** ثبت عنصر، فقط در مرورگر و فقط یک بار (اگر پکیج دو بار بارگذاری شود خطا نمی‌دهد) */
@@ -7,6 +8,412 @@ export declare function define(tag: string, ctor: CustomElementConstructor, disp
  * اگر اسکریپت بدون type="module" در <head> باشد، عنصر پیش از فرزندانش به صفحه وصل می‌شود.
  */
 export declare function afterParse(cb: () => void): void;
+type Digits = "fa" | "latin";
+/**
+ * زبان متن‌های داخلی همهٔ عنصرها: setLocale("en") برچسب دکمه‌ها، متن صفحه‌خوان، پیام‌های خطا، نام ماه‌ها و ارقام را انگلیسی می‌کند.
+ * پیش از ساخته شدن عنصرها صدا بزنید (بالای صفحه، بعد از import). با messages هر متنی را عوض کنید.
+ */
+export declare function setLocale(locale: KashiLocale, { messages, digits }?: {
+    messages?: KashiMessagesInput;
+    digits?: Digits;
+}): void;
+/** ارقام پیش‌فرض زبان فعلی */
+export declare const localeDigits: () => Digits;
+/** فرهنگ متن‌های فعلی */
+export declare const msg: () => {
+    common: {
+        close: string;
+        loading: string;
+        optional: string;
+        remove: (item: string) => string;
+        removeShort: string;
+        clear: string;
+        clearAll: string;
+        cancel: string;
+        confirm: string;
+        save: string;
+        edit: string;
+        prev: string;
+        next: string;
+        today: string;
+        tomorrow: string;
+        noResults: string;
+        searching: string;
+        results: (n: string) => string;
+        added: (item: string) => string;
+        removed: (item: string) => string;
+        selected: (item: string) => string;
+        max: (n: string) => string;
+        total: string;
+        other: string;
+        of: (a: string, b: string) => string;
+        and: string;
+        list: string;
+        range: string;
+        percent: (n: string) => string;
+        decimal: string;
+    };
+    money: {
+        toman: string;
+        rial: string;
+        positive: string;
+    };
+    alert: {
+        close: string;
+    };
+    banner: {
+        label: string;
+        close: string;
+    };
+    avatar: {
+        online: string;
+        offline: string;
+        busy: string;
+        away: string;
+        more: (n: string) => string;
+    };
+    bankCard: {
+        card: string;
+        cardOf: (bank: string) => string;
+        bank: string;
+        endingIn: (last4: string) => string;
+        expiry: string;
+    };
+    breadcrumb: {
+        label: string;
+        expand: string;
+    };
+    calendar: {
+        label: string;
+        prevMonth: string;
+        nextMonth: string;
+        month: string;
+        year: string;
+        holiday: string;
+    };
+    carousel: {
+        slider: string;
+        slide: string;
+        slideOf: (n: string, total: string) => string;
+        slides: (label: string) => string;
+    };
+    chart: {
+        period: string;
+        value: string;
+        share: string;
+        count: string;
+        keyboard: (title: string) => string;
+        thousand: string;
+        million: string;
+        billion: string;
+    };
+    city: {
+        label: string;
+        outside: string;
+        custom: string;
+        search: string;
+        hint: string;
+    };
+    province: {
+        label: string;
+        search: string;
+        capital: (c: string) => string;
+    };
+    colorPicker: {
+        label: string;
+        custom: string;
+        area: string;
+        areaValue: (s: string, v: string) => string;
+        eyedropper: string;
+        hue: string;
+        degrees: (n: string) => string;
+        red: string;
+        green: string;
+        blue: string;
+        invalid: string;
+        swatches: string;
+        sample: string;
+        contrast: (ink: "white" | "black", ratio: string, pass: boolean) => string;
+        names: {
+            firoozeh: string;
+            lajvard: string;
+            violet: string;
+            anar: string;
+            zafaran: string;
+            peste: string;
+            shab: string;
+        };
+    };
+    combobox: {
+        toggle: string;
+        more: (n: string) => string;
+    };
+    otp: {
+        label: string;
+    };
+    command: {
+        placeholder: string;
+        empty: string;
+        title: string;
+        navigate: string;
+        select: string;
+    };
+    contextMenu: {
+        label: string;
+        hint: string;
+    };
+    copy: {
+        copy: string;
+        copied: string;
+        failed: string;
+    };
+    countdown: {
+        days: string;
+        hours: string;
+        minutes: string;
+        seconds: string;
+        left: string;
+    };
+    table: {
+        selectAll: string;
+        selectRow: string;
+        selectNamed: (row: string) => string;
+        empty: string;
+        sort: (col: string) => string;
+        search: string;
+        rows: (n: string) => string;
+    };
+    datePicker: {
+        label: string;
+        invalid: string;
+        open: string;
+    };
+    dateRange: {
+        label: string;
+        placeholder: string;
+        presets: string;
+        pickEnd: string;
+        last7: (n: string) => string;
+        last30: (n: string) => string;
+        thisMonth: string;
+        lastMonth: string;
+    };
+    monthPicker: {
+        label: string;
+        prevYear: string;
+        nextYear: string;
+    };
+    fileUpload: {
+        units: string[];
+        browse: string;
+        drop: string;
+        tooBig: (max: string) => string;
+        wrongType: string;
+        tooMany: (n: string) => string;
+        done: string;
+        uploading: string;
+        uploadingFile: (name: string) => string;
+        error: string;
+    };
+    input: {
+        clear: string;
+        show: string;
+        hide: string;
+        checking: string;
+    };
+    invalid: {
+        card: string;
+        iban: string;
+        nationalId: string;
+        legalId: string;
+        mobile: string;
+        landline: string;
+        postal: string;
+        plate: string;
+        time: string;
+        timeRange: (a: string, b: string) => string;
+        priceMin: (n: string) => string;
+        priceMax: (n: string) => string;
+        priceRange: (a: string, b: string) => string;
+    };
+    inlineEdit: {
+        empty: string;
+        failed: string;
+    };
+    iranMap: {
+        label: string;
+        tableNote: string;
+        onMap: (label: string) => string;
+    };
+    keyboardFix: {
+        before: string;
+        after: string;
+    };
+    meter: {
+        ok: string;
+        warning: string;
+        critical: string;
+    };
+    multiSelect: {
+        label: string;
+        selected: (n: string) => string;
+        clearedAll: string;
+    };
+    numberInput: {
+        label: string;
+        increment: string;
+        decrement: string;
+    };
+    pagination: {
+        nav: string;
+        page: (n: string) => string;
+        perPage: string;
+        jump: string;
+        jumpRange: (jump: string, a: string, b: string) => string;
+    };
+    password: {
+        title: string;
+        strength: (level: string) => string;
+        levels: string[];
+        persian: string;
+        length: (n: string) => string;
+        cases: string;
+        digit: string;
+        symbol: string;
+        met: string;
+        unmet: string;
+    };
+    receipt: {
+        success: string;
+        failed: string;
+        pending: string;
+        merchant: string;
+        tracking: string;
+        copyTracking: string;
+        reference: string;
+        card: string;
+        date: string;
+        at: (time: string) => string;
+    };
+    persianInput: {
+        text: string;
+        "national-id": string;
+        "legal-id": string;
+        mobile: string;
+        landline: string;
+        card: string;
+        iban: string;
+        price: string;
+        postal: string;
+        time: string;
+        plate: string;
+    };
+    textFix: {
+        fix: string;
+        clean: string;
+        count: (n: string, summary: string) => string;
+        arabic: string;
+        zwnj: string;
+        punctuation: string;
+        digits: string;
+        spacing: string;
+    };
+    plate: {
+        label: string;
+        first: string;
+        letter: string;
+        middle: string;
+        region: string;
+        iran: string;
+    };
+    rating: {
+        label: string;
+    };
+    sideNav: {
+        label: string;
+    };
+    slider: {
+        from: string;
+        to: string;
+    };
+    splitter: {
+        label: string;
+    };
+    stat: {
+        up: string;
+        down: string;
+        flat: string;
+    };
+    stepper: {
+        label: string;
+        complete: string;
+        current: string;
+    };
+    tagInput: {
+        label: string;
+        duplicate: string;
+    };
+    toast: {
+        region: string;
+        close: string;
+    };
+    tour: {
+        done: string;
+        skip: string;
+        step: (n: string, total: string) => string;
+    };
+    heatmap: {
+        unit: string;
+        weekdays: string[];
+        inYear: (unit: string, year: string) => string;
+        total: (n: string, unit: string, year: string) => string;
+        less: string;
+        more: string;
+        byMonth: (name: string) => string;
+    };
+    appointment: {
+        label: string;
+        day: string;
+        morning: string;
+        afternoon: string;
+        evening: string;
+        closed: string;
+        full: string;
+        free: (n: string) => string;
+        freeLong: (n: string) => string;
+        none: string;
+        closedDay: string;
+        noSlots: string;
+        time: (t: string) => string;
+        booked: string;
+        yours: string;
+        at: (date: string, time: string) => string;
+    };
+    address: {
+        legend: string;
+        province: string;
+        city: string;
+        street: string;
+        plaque: string;
+        unit: string;
+        postalCode: string;
+        provinceSearch: string;
+        streetHint: string;
+    };
+};
+/** زبان فعلی */
+export declare const lang: () => KashiLocale;
+/** ارقام عنصر: ویژگی digits، وگرنه پیش‌فرض زبان */
+export declare const digitsOf: (el: Element) => Digits;
+/** عدد با ارقام همان عنصر */
+export declare const num: (el: Element, v: number | string) => string;
+/** نام ماه‌ها و روزهای شمسی به زبان فعلی */
+export declare const calendarNames: () => {
+    months: readonly ["Farvardin", "Ordibehesht", "Khordad", "Tir", "Mordad", "Shahrivar", "Mehr", "Aban", "Azar", "Dey", "Bahman", "Esfand"] | readonly ["فروردین", "اردیبهشت", "خرداد", "تیر", "مرداد", "شهریور", "مهر", "آبان", "آذر", "دی", "بهمن", "اسفند"];
+    weekdays: readonly ["Saturday", "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday"] | readonly ["شنبه", "یکشنبه", "دوشنبه", "سه‌شنبه", "چهارشنبه", "پنجشنبه", "جمعه"];
+    weekdaysShort: readonly ["Sa", "Su", "Mo", "Tu", "We", "Th", "Fr"] | readonly ["ش", "ی", "د", "س", "چ", "پ", "ج"];
+    friday: string;
+};
 /** شناسهٔ یکتا برای اتصال برچسب، راهنما و خطا */
 export declare const uid: (prefix: string) => string;
 /** متن امن برای قرار دادن در HTML */
@@ -45,3 +452,4 @@ export declare function fieldHTML({ id, label, required, optional, control }: Fi
 export declare function setMessages(field: Element, control: HTMLElement, id: string, error: string | null, hint: string | null, extra?: string | null): void;
 /** فیلد پنهان برای ارسال مقدار خام در فرم HTML معمولی */
 export declare function syncHidden(host: Element, name: string | null, value: string): void;
+export {};