@kashi-ui/elements 0.24.0 → 0.25.0

package/dist/index.d.ts

@@ -5,17 +5,22 @@ import { KashiAddressForm, KashiIranMap } from "./map.js";
 import { KashiDropdownMenu, KashiPopover } from "./menu.js";
 import { KashiNumberInput, KashiPagination, KashiRating, KashiTagInput } from "./controls.js";
 import { KashiDataTable } from "./table.js";
+import { KashiChipGroup, KashiInlineEdit, KashiKeyboardFix, KashiMultiSelect, KashiPasswordStrength, KashiPersianTextarea, KashiPlateInput, KashiSlider, KashiTimeInput } from "./forms.js";
+import { KashiColorPicker, KashiDateRangePicker, KashiFileUpload, KashiMonthPicker } from "./pickers.js";
+import { KashiActivityHeatmap, KashiBarChart, KashiBarList, KashiLineChart, KashiPieChart, KashiProportionBar, KashiSparkline } from "./charts.js";
+import { KashiCarousel, KashiCommandPalette, KashiContextMenu, KashiSideNav, KashiSplitter, KashiTour, KashiTreeView } from "./nav.js";
 import { KashiCalendar, KashiDatePicker } from "./calendar.js";
 import { KashiCountdown, KashiDate, KashiMoney, KashiRelativeTime } from "./display.js";
 import { KashiCopyButton, KashiDialog, KashiTabs, KashiTooltip } from "./overlay.js";
 import { KashiToaster, toast } from "./toast.js";
-export { KashiCardNumber, KashiIban, KashiLandline, KashiLegalId, KashiMobile, KashiNationalId, KashiPostalCode, KashiPrice, KashiOtp, KashiProvinceSelect, KashiCombobox, KashiCitySelect, KashiIranMap, KashiAddressForm, KashiCalendar, KashiDatePicker, KashiCountdown, KashiDate, KashiMoney, KashiRelativeTime, KashiCopyButton, KashiDialog, KashiTabs, KashiTooltip, KashiToaster, toast, KashiDropdownMenu, KashiPopover, KashiTagInput, KashiNumberInput, KashiRating, KashiPagination, KashiDataTable, };
+export { KashiCardNumber, KashiIban, KashiLandline, KashiLegalId, KashiMobile, KashiNationalId, KashiPostalCode, KashiPrice, KashiOtp, KashiProvinceSelect, KashiCombobox, KashiCitySelect, KashiIranMap, KashiAddressForm, KashiCalendar, KashiDatePicker, KashiCountdown, KashiDate, KashiMoney, KashiRelativeTime, KashiCopyButton, KashiDialog, KashiTabs, KashiTooltip, KashiToaster, toast, KashiDropdownMenu, KashiPopover, KashiTagInput, KashiNumberInput, KashiRating, KashiPagination, KashiDataTable, KashiMultiSelect, KashiSlider, KashiChipGroup, KashiPasswordStrength, KashiPersianTextarea, KashiKeyboardFix, KashiTimeInput, KashiPlateInput, KashiInlineEdit, KashiDateRangePicker, KashiMonthPicker, KashiFileUpload, KashiColorPicker, KashiBarChart, KashiLineChart, KashiPieChart, KashiBarList, KashiProportionBar, KashiSparkline, KashiActivityHeatmap, KashiCommandPalette, KashiContextMenu, KashiCarousel, KashiTreeView, KashiTour, KashiSplitter, KashiSideNav, };
 export { KashiDigitsInput } from "./inputs.js";
 export type { ToastOptions, ToastTone } from "./toast.js";
 export type { ComboboxOption } from "./combobox.js";
 export type { TableColumn } from "./table.js";
+export type { CommandItem, TourStep, TreeNode } from "./nav.js";
 /** نام همهٔ عنصرها؛ مثلاً برای isCustomElement در Vue */
-export declare const KASHI_ELEMENTS: readonly ["kashi-national-id", "kashi-legal-id", "kashi-mobile", "kashi-landline", "kashi-card-number", "kashi-iban", "kashi-postal-code", "kashi-price", "kashi-otp", "kashi-combobox", "kashi-province-select", "kashi-city-select", "kashi-iran-map", "kashi-address-form", "kashi-calendar", "kashi-date-picker", "kashi-money", "kashi-date", "kashi-relative-time", "kashi-countdown", "kashi-dialog", "kashi-tabs", "kashi-tooltip", "kashi-copy-button", "kashi-toaster", "kashi-dropdown-menu", "kashi-popover", "kashi-tag-input", "kashi-number-input", "kashi-rating", "kashi-pagination", "kashi-data-table"];
+export declare const KASHI_ELEMENTS: readonly ["kashi-national-id", "kashi-legal-id", "kashi-mobile", "kashi-landline", "kashi-card-number", "kashi-iban", "kashi-postal-code", "kashi-price", "kashi-otp", "kashi-combobox", "kashi-province-select", "kashi-city-select", "kashi-iran-map", "kashi-address-form", "kashi-calendar", "kashi-date-picker", "kashi-money", "kashi-date", "kashi-relative-time", "kashi-countdown", "kashi-dialog", "kashi-tabs", "kashi-tooltip", "kashi-copy-button", "kashi-toaster", "kashi-dropdown-menu", "kashi-popover", "kashi-tag-input", "kashi-number-input", "kashi-rating", "kashi-pagination", "kashi-data-table", "kashi-multi-select", "kashi-slider", "kashi-chip-group", "kashi-password-strength", "kashi-persian-textarea", "kashi-keyboard-fix", "kashi-time-input", "kashi-plate-input", "kashi-inline-edit", "kashi-date-range-picker", "kashi-month-picker", "kashi-file-upload", "kashi-color-picker", "kashi-bar-chart", "kashi-line-chart", "kashi-pie-chart", "kashi-bar-list", "kashi-proportion-bar", "kashi-sparkline", "kashi-activity-heatmap", "kashi-command-palette", "kashi-context-menu", "kashi-carousel", "kashi-tree-view", "kashi-tour", "kashi-splitter", "kashi-side-nav"];
 declare global {
     interface HTMLElementTagNameMap {
         "kashi-national-id": KashiNationalId;
@@ -50,5 +55,32 @@ declare global {
         "kashi-rating": KashiRating;
         "kashi-pagination": KashiPagination;
         "kashi-data-table": KashiDataTable;
+        "kashi-multi-select": KashiMultiSelect;
+        "kashi-slider": KashiSlider;
+        "kashi-chip-group": KashiChipGroup;
+        "kashi-password-strength": KashiPasswordStrength;
+        "kashi-persian-textarea": KashiPersianTextarea;
+        "kashi-keyboard-fix": KashiKeyboardFix;
+        "kashi-time-input": KashiTimeInput;
+        "kashi-plate-input": KashiPlateInput;
+        "kashi-inline-edit": KashiInlineEdit;
+        "kashi-date-range-picker": KashiDateRangePicker;
+        "kashi-month-picker": KashiMonthPicker;
+        "kashi-file-upload": KashiFileUpload;
+        "kashi-color-picker": KashiColorPicker;
+        "kashi-bar-chart": KashiBarChart;
+        "kashi-line-chart": KashiLineChart;
+        "kashi-pie-chart": KashiPieChart;
+        "kashi-bar-list": KashiBarList;
+        "kashi-proportion-bar": KashiProportionBar;
+        "kashi-sparkline": KashiSparkline;
+        "kashi-activity-heatmap": KashiActivityHeatmap;
+        "kashi-command-palette": KashiCommandPalette;
+        "kashi-context-menu": KashiContextMenu;
+        "kashi-carousel": KashiCarousel;
+        "kashi-tree-view": KashiTreeView;
+        "kashi-tour": KashiTour;
+        "kashi-splitter": KashiSplitter;
+        "kashi-side-nav": KashiSideNav;
     }
 }

package/dist/index.js

@@ -7,11 +7,15 @@ import { KashiAddressForm, KashiIranMap } from "./map.js";
 import { KashiDropdownMenu, KashiPopover } from "./menu.js";
 import { KashiNumberInput, KashiPagination, KashiRating, KashiTagInput } from "./controls.js";
 import { KashiDataTable } from "./table.js";
+import { KashiChipGroup, KashiInlineEdit, KashiKeyboardFix, KashiMultiSelect, KashiPasswordStrength, KashiPersianTextarea, KashiPlateInput, KashiSlider, KashiTimeInput, } from "./forms.js";
+import { KashiColorPicker, KashiDateRangePicker, KashiFileUpload, KashiMonthPicker } from "./pickers.js";
+import { KashiActivityHeatmap, KashiBarChart, KashiBarList, KashiLineChart, KashiPieChart, KashiProportionBar, KashiSparkline, } from "./charts.js";
+import { KashiCarousel, KashiCommandPalette, KashiContextMenu, KashiSideNav, KashiSplitter, KashiTour, KashiTreeView } from "./nav.js";
 import { KashiCalendar, KashiDatePicker } from "./calendar.js";
 import { KashiCountdown, KashiDate, KashiMoney, KashiRelativeTime } from "./display.js";
 import { KashiCopyButton, KashiDialog, KashiTabs, KashiTooltip } from "./overlay.js";
 import { KashiToaster, toast } from "./toast.js";
-export { KashiCardNumber, KashiIban, KashiLandline, KashiLegalId, KashiMobile, KashiNationalId, KashiPostalCode, KashiPrice, KashiOtp, KashiProvinceSelect, KashiCombobox, KashiCitySelect, KashiIranMap, KashiAddressForm, KashiCalendar, KashiDatePicker, KashiCountdown, KashiDate, KashiMoney, KashiRelativeTime, KashiCopyButton, KashiDialog, KashiTabs, KashiTooltip, KashiToaster, toast, KashiDropdownMenu, KashiPopover, KashiTagInput, KashiNumberInput, KashiRating, KashiPagination, KashiDataTable, };
+export { KashiCardNumber, KashiIban, KashiLandline, KashiLegalId, KashiMobile, KashiNationalId, KashiPostalCode, KashiPrice, KashiOtp, KashiProvinceSelect, KashiCombobox, KashiCitySelect, KashiIranMap, KashiAddressForm, KashiCalendar, KashiDatePicker, KashiCountdown, KashiDate, KashiMoney, KashiRelativeTime, KashiCopyButton, KashiDialog, KashiTabs, KashiTooltip, KashiToaster, toast, KashiDropdownMenu, KashiPopover, KashiTagInput, KashiNumberInput, KashiRating, KashiPagination, KashiDataTable, KashiMultiSelect, KashiSlider, KashiChipGroup, KashiPasswordStrength, KashiPersianTextarea, KashiKeyboardFix, KashiTimeInput, KashiPlateInput, KashiInlineEdit, KashiDateRangePicker, KashiMonthPicker, KashiFileUpload, KashiColorPicker, KashiBarChart, KashiLineChart, KashiPieChart, KashiBarList, KashiProportionBar, KashiSparkline, KashiActivityHeatmap, KashiCommandPalette, KashiContextMenu, KashiCarousel, KashiTreeView, KashiTour, KashiSplitter, KashiSideNav, };
 export { KashiDigitsInput } from "./inputs.js";
 /** نام همهٔ عنصرها؛ مثلاً برای isCustomElement در Vue */
 export const KASHI_ELEMENTS = [
@@ -20,4 +24,9 @@ export const KASHI_ELEMENTS = [
     "kashi-money", "kashi-date", "kashi-relative-time", "kashi-countdown",
     "kashi-dialog", "kashi-tabs", "kashi-tooltip", "kashi-copy-button", "kashi-toaster",
     "kashi-dropdown-menu", "kashi-popover", "kashi-tag-input", "kashi-number-input", "kashi-rating", "kashi-pagination", "kashi-data-table",
+    "kashi-multi-select", "kashi-slider", "kashi-chip-group", "kashi-password-strength", "kashi-persian-textarea", "kashi-keyboard-fix",
+    "kashi-time-input", "kashi-plate-input", "kashi-inline-edit",
+    "kashi-date-range-picker", "kashi-month-picker", "kashi-file-upload", "kashi-color-picker",
+    "kashi-bar-chart", "kashi-line-chart", "kashi-pie-chart", "kashi-bar-list", "kashi-proportion-bar", "kashi-sparkline", "kashi-activity-heatmap",
+    "kashi-command-palette", "kashi-context-menu", "kashi-carousel", "kashi-tree-view", "kashi-tour", "kashi-splitter", "kashi-side-nav",
 ];

package/dist/nav.d.ts

@@ -0,0 +1,163 @@
+import { HTMLBase } from "./base.js";
+export interface CommandItem {
+    id: string;
+    label: string;
+    group?: string;
+    description?: string;
+    shortcut?: string;
+    keywords?: string[];
+    href?: string;
+}
+/**
+ * پالت فرمان با Ctrl+K یا ⌘K: جستجو بین دستورها و صفحه‌ها با ↑↓ و Enter.
+ * دستورها از فرزندان <a href> یا <button data-value> (با data-group، data-description، data-shortcut، data-keywords)
+ * یا element.items؛ انتخاب هر دستور بدون href رویداد kashi-select می‌فرستد.
+ */
+export declare class KashiCommandPalette extends HTMLBase {
+    static observedAttributes: string[];
+    private list;
+    private dialog;
+    private query;
+    private active;
+    private opener;
+    private key;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    get items(): CommandItem[];
+    set items(v: CommandItem[]);
+    private readItems;
+    private onShortcut;
+    private build;
+    private filtered;
+    /** باز کردن پالت */
+    show(): void;
+    close(): void;
+    private run;
+    private paint;
+}
+/**
+ * منوی راست‌کلیک: محتوای عنصر ناحیهٔ کلیک است و گزینه‌ها داخل یک <div data-menu> (همان گزینه‌های kashi-dropdown-menu).
+ * با راست‌کلیک، کلید ContextMenu یا Shift+F10 باز می‌شود؛ انتخاب گزینه رویداد kashi-select می‌فرستد.
+ */
+export declare class KashiContextMenu extends HTMLBase {
+    static observedAttributes: string[];
+    private menu;
+    private returnTo;
+    private key;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private build;
+    private openAt;
+    close(focusBack?: boolean): void;
+    private onOutside;
+    private onScroll;
+    private onMenuKey;
+}
+/** اسلایدر محتوا با اسکرول بومی: هر فرزند یک اسلاید؛ per-view تعداد اسلاید در هر نما، کلیدهای جهت و نقطه‌ها */
+export declare class KashiCarousel extends HTMLBase {
+    static observedAttributes: string[];
+    private track;
+    private index;
+    private io;
+    private key;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private get perView();
+    private get slides();
+    private get pages();
+    private build;
+    /** رفتن به اسلاید n (از صفر) */
+    go(n: number): void;
+    private setIndex;
+}
+export interface TreeNode {
+    id: string;
+    label: string;
+    meta?: string;
+    disabled?: boolean;
+    children?: TreeNode[];
+}
+/**
+ * نمای درختی با الگوی Tree در WAI-ARIA. ساختار از یک فهرست تودرتوی معمولی (<ul><li data-id>…<ul>…</ul></li></ul>)
+ * یا element.items؛ ↑↓ حرکت، جهت داخل باز کردن (در RTL فلش چپ)، Enter انتخاب.
+ */
+export declare class KashiTreeView extends HTMLBase {
+    static observedAttributes: string[];
+    private nodes;
+    private open;
+    private sel;
+    private focusId;
+    private built;
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, old: string | null, next: string | null): void;
+    get items(): TreeNode[];
+    set items(v: TreeNode[]);
+    /** شناسهٔ گرهٔ انتخاب‌شده */
+    get value(): string;
+    private parse;
+    private visible;
+    private render;
+    private find;
+    private toggle;
+    private choose;
+    private onKey;
+}
+export interface TourStep {
+    target: string;
+    title: string;
+    content: string;
+}
+/**
+ * تور معرفی: کارت راهنما کنار هر بخش صفحه با برجسته کردن آن. مراحل از فرزندان <div data-target="#id" data-title="…">متن</div>
+ * یا element.steps؛ با element.start() یا دکمه‌ای با data-kashi-tour="شناسهٔ تور" شروع می‌شود.
+ */
+export declare class KashiTour extends HTMLBase {
+    private list;
+    private i;
+    private spot;
+    private card;
+    private returnTo;
+    private key;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    get steps(): TourStep[];
+    set steps(v: TourStep[]);
+    /** شروع تور از مرحلهٔ اول */
+    start(): void;
+    /** پایان تور */
+    stop(focusBack?: boolean): void;
+    private show;
+    private step;
+    private place;
+}
+/**
+ * دو پنل با جداکنندهٔ قابل کشیدن: دو فرزند اول پنل‌ها هستند؛ با کیبورد ←→ (یا ↑↓ در حالت vertical) و دوبار کلیک برای اندازهٔ اولیه.
+ */
+export declare class KashiSplitter extends HTMLBase {
+    static observedAttributes: string[];
+    private current;
+    private built;
+    private dragging;
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, old: string | null, next: string | null): void;
+    /** اندازهٔ پنل اول به درصد */
+    get value(): number;
+    set value(v: number);
+    private num;
+    private get vertical();
+    private build;
+    private decorate;
+    private set;
+    private paint;
+}
+/**
+ * منوی کناری: همان HTML منوی کناری کاشی (تب HTML صفحهٔ آن) را داخلش بگذارید؛ زیرمنوها
+ * (دکمه با aria-controls) با کلیک باز و بسته می‌شوند و با collapsed فقط آیکون‌ها می‌مانند.
+ */
+export declare class KashiSideNav extends HTMLBase {
+    static observedAttributes: string[];
+    private built;
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private decorate;
+}