@amirjalili1374/ui-kit 1.10.8 → 1.10.10

package/README.md

@@ -2,6 +2,8 @@
 
 A reusable UI component library built with Vue 3, Vuetify 3, and TypeScript. This library provides a comprehensive set of components, composables, utilities, and directives for building modern web applications.
 
+Provider configuration, localization, themes, semantic icons, permissions, async state, RTL/LTR behavior, public exports, consumer setup, and testing are covered in [UI platform foundations](docs/PLATFORM_FOUNDATIONS.md).
+
 ## Features
 
 - 🎨 Built with Vue 3 Composition API
@@ -272,6 +274,13 @@ const formatted = formatNumberWithCommas(1234567); // "1,234,567"
 - `AppStepper` - Step-by-step wizard component
 - `Loading` - Loading overlay component
 
+### Form Presentation Components
+- `UiField` - Accessible label, hint, error, and success structure for consumer-owned controls
+- `UiFieldMessage` - Semantic hint, error, success, and warning feedback
+- `UiFormActions` - Localized submit, cancel, and secondary action presentation
+
+See [Form presentation components](docs/components/FORM_PRESENTATION.md) for contracts and adoption guidance.
+
 ### Layout Components
 - `AppSidebar` - Navigation sidebar with menu items, logo, and mini sidebar support
 - `AppHeader` - Top header bar with search, notifications, profile menu, and custom actions

package/dist/components/common/AppStepper.vue.d.ts

@@ -73,7 +73,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     "onUpdate:modelValue"?: (...args: any[]) => any;
     "onStep-click"?: (...args: any[]) => any;
 }>, {
-    direction: "ltr" | "rtl";
+    direction: "rtl" | "ltr";
     contentMinHeight: string;
     disableClick: boolean;
     stepProps: Record<string, any>;

package/dist/components/form/UiField.vue.d.ts

@@ -0,0 +1,57 @@
+type __VLS_Props = {
+    id?: string;
+    label?: string;
+    hint?: string;
+    errors?: string | readonly string[];
+    success?: string;
+    required?: boolean;
+    disabled?: boolean;
+    readonly?: boolean;
+    direction?: 'rtl' | 'ltr';
+};
+declare var __VLS_1: {
+    id: string;
+    required: boolean;
+}, __VLS_3: {
+    id: string;
+    disabled: boolean;
+    readonly: boolean;
+    required: boolean;
+    'aria-invalid': boolean;
+    'aria-describedby': string;
+}, __VLS_5: {
+    id: string;
+    disabled: boolean;
+    readonly: boolean;
+    required: boolean;
+    'aria-invalid': boolean;
+    'aria-describedby': string;
+}, __VLS_13: {}, __VLS_21: {
+    errors: string[];
+}, __VLS_29: {};
+type __VLS_Slots = {} & {
+    label?: (props: typeof __VLS_1) => any;
+} & {
+    action?: (props: typeof __VLS_3) => any;
+} & {
+    default?: (props: typeof __VLS_5) => any;
+} & {
+    hint?: (props: typeof __VLS_13) => any;
+} & {
+    error?: (props: typeof __VLS_21) => any;
+} & {
+    success?: (props: typeof __VLS_29) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    required: boolean;
+    disabled: boolean;
+    readonly: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/form/UiFieldMessage.vue.d.ts

@@ -0,0 +1,29 @@
+import type { UiIconSource } from '../../platform/types';
+import type { UiFieldMessageVariant } from './types';
+type __VLS_Props = {
+    id?: string;
+    message?: string;
+    variant?: UiFieldMessageVariant;
+    icon?: UiIconSource;
+    hideIcon?: boolean;
+};
+declare var __VLS_1: {
+    icon: UiIconSource;
+}, __VLS_8: {};
+type __VLS_Slots = {} & {
+    icon?: (props: typeof __VLS_1) => any;
+} & {
+    default?: (props: typeof __VLS_8) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    variant: UiFieldMessageVariant;
+    hideIcon: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/form/UiFormActions.vue.d.ts

@@ -0,0 +1,45 @@
+import type { UiFormActionsAlign } from './types';
+type __VLS_Props = {
+    submitLabel?: string;
+    cancelLabel?: string;
+    loading?: boolean;
+    disabled?: boolean;
+    cancelDisabled?: boolean;
+    showCancel?: boolean;
+    align?: UiFormActionsAlign;
+    sticky?: boolean;
+    direction?: 'rtl' | 'ltr';
+};
+declare var __VLS_1: {}, __VLS_3: {
+    submit: () => void;
+    cancel: () => void;
+    loading: boolean;
+    disabled: boolean;
+};
+type __VLS_Slots = {} & {
+    secondary?: (props: typeof __VLS_1) => any;
+} & {
+    default?: (props: typeof __VLS_3) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    cancel: () => any;
+    submit: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCancel?: () => any;
+    onSubmit?: () => any;
+}>, {
+    loading: boolean;
+    sticky: boolean;
+    align: UiFormActionsAlign;
+    disabled: boolean;
+    cancelDisabled: boolean;
+    showCancel: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/form/types.d.ts

@@ -0,0 +1,2 @@
+export type UiFieldMessageVariant = 'hint' | 'error' | 'success' | 'warning';
+export type UiFormActionsAlign = 'start' | 'center' | 'end' | 'space-between';

package/dist/components/layout/AppCustomizer.vue.d.ts

@@ -1,7 +1,9 @@
 declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     save: (payload: string) => any;
+    "suggest-language-change": (language: "fa" | "en") => any;
 }, string, import("vue").PublicProps, Readonly<{}> & Readonly<{
     onSave?: (payload: string) => any;
+    "onSuggest-language-change"?: (language: "fa" | "en") => any;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/layout/AppCustomizerControls.vue.d.ts

@@ -9,15 +9,15 @@ type __VLS_Props = {
     showActions?: boolean;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    reset: () => any;
     apply: () => any;
+    reset: () => any;
     "update:textFieldBorderRadius": (value: number) => any;
     "update:textFieldVariant": (value: TextFieldVariant) => any;
     "update:textFieldHeight": (value: TextFieldHeight) => any;
     "update:textScale": (value: number) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onReset?: () => any;
     onApply?: () => any;
+    onReset?: () => any;
     "onUpdate:textFieldBorderRadius"?: (value: number) => any;
     "onUpdate:textFieldVariant"?: (value: TextFieldVariant) => any;
     "onUpdate:textFieldHeight"?: (value: TextFieldHeight) => any;

package/dist/components/layout/AppCustomizerPanel.vue.d.ts

@@ -1,4 +1,5 @@
 import { type TextFieldHeight, type TextFieldVariant } from './AppCustomizerControls.vue';
+import { type AppDirection, type AppLanguage } from '../../utils/customizerPreferences';
 export interface CustomizerThemeOption {
     themeName: string;
     primary: string;
@@ -21,45 +22,53 @@ type __VLS_Props = {
     menuOrientation: MenuOrientation;
     surfaceStyle?: SurfaceStyle;
     contentWidth?: ContentWidth;
+    language?: AppLanguage;
+    direction?: AppDirection;
     inputBg?: boolean;
     layoutType?: string;
     width?: number;
     fontLabel?: (font: string) => string;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    apply: (payload: string) => any;
     reset: () => any;
     "update:modelValue": (value: boolean) => any;
-    apply: (payload: string) => any;
     "update:textFieldBorderRadius": (value: number) => any;
     "update:textFieldVariant": (value: TextFieldVariant) => any;
     "update:textFieldHeight": (value: TextFieldHeight) => any;
     "update:textScale": (value: number) => any;
-    "update:themeMode": (value: "light" | "dark") => any;
+    "update:themeMode": (value: "dark" | "light") => any;
     "update:activeTheme": (value: string) => any;
     "update:fontTheme": (value: string) => any;
     "update:menuOrientation": (value: MenuOrientation) => any;
     "update:surfaceStyle": (value: SurfaceStyle) => any;
     "update:contentWidth": (value: ContentWidth) => any;
+    "update:direction": (value: AppDirection) => any;
+    "suggest-language-change": (language: AppLanguage) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onApply?: (payload: string) => any;
     onReset?: () => any;
     "onUpdate:modelValue"?: (value: boolean) => any;
-    onApply?: (payload: string) => any;
     "onUpdate:textFieldBorderRadius"?: (value: number) => any;
     "onUpdate:textFieldVariant"?: (value: TextFieldVariant) => any;
     "onUpdate:textFieldHeight"?: (value: TextFieldHeight) => any;
     "onUpdate:textScale"?: (value: number) => any;
-    "onUpdate:themeMode"?: (value: "light" | "dark") => any;
+    "onUpdate:themeMode"?: (value: "dark" | "light") => any;
     "onUpdate:activeTheme"?: (value: string) => any;
     "onUpdate:fontTheme"?: (value: string) => any;
     "onUpdate:menuOrientation"?: (value: MenuOrientation) => any;
     "onUpdate:surfaceStyle"?: (value: SurfaceStyle) => any;
     "onUpdate:contentWidth"?: (value: ContentWidth) => any;
+    "onUpdate:direction"?: (value: AppDirection) => any;
+    "onSuggest-language-change"?: (language: AppLanguage) => any;
 }>, {
+    direction: AppDirection;
     width: number;
     inputBg: boolean;
     layoutType: string;
     surfaceStyle: SurfaceStyle;
     contentWidth: ContentWidth;
+    language: AppLanguage;
     fontLabel: (font: string) => string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/components/layout/AppHeaderMenu.vue.d.ts

@@ -11,6 +11,11 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
         type: PropType<"bar" | "menu">;
         default: string;
     };
+    /** Maximum number of top-level navigation items shown directly in the desktop bar. */
+    maxVisible: {
+        type: NumberConstructor;
+        default: number;
+    };
 }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     /** Already-filtered navigation items supplied by the consuming application. */
     items: {
@@ -22,9 +27,15 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
         type: PropType<"bar" | "menu">;
         default: string;
     };
+    /** Maximum number of top-level navigation items shown directly in the desktop bar. */
+    maxVisible: {
+        type: NumberConstructor;
+        default: number;
+    };
 }>> & Readonly<{}>, {
-    items: MenuItem[];
     display: "menu" | "bar";
+    items: MenuItem[];
+    maxVisible: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/permissions/PermissionGuard.vue.d.ts

@@ -0,0 +1,30 @@
+import type { UiPermissionInput } from '../../platform/types';
+type __VLS_Props = {
+    permission?: UiPermissionInput;
+    any?: string[];
+    all?: string[];
+    mode?: 'hide' | 'disable';
+};
+declare var __VLS_1: {
+    allowed: boolean;
+}, __VLS_3: {
+    allowed: boolean;
+}, __VLS_5: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+} & {
+    default?: (props: typeof __VLS_3) => any;
+} & {
+    fallback?: (props: typeof __VLS_5) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    mode: "hide" | "disable";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/shared/AppConfirmAction.vue.d.ts

@@ -8,17 +8,17 @@ type __VLS_Props = {
     loading?: boolean;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (value: boolean) => any;
     confirm: () => any;
     cancel: () => any;
+    "update:modelValue": (value: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:modelValue"?: (value: boolean) => any;
     onConfirm?: () => any;
     onCancel?: () => any;
+    "onUpdate:modelValue"?: (value: boolean) => any;
 }>, {
-    title: string;
-    color: string;
     loading: boolean;
+    color: string;
+    title: string;
     confirmText: string;
     cancelText: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/components/shared/AppFilePreview.vue.d.ts

@@ -15,11 +15,11 @@ type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_53) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    remove: (file: PreviewFile) => any;
     download: (file: PreviewFile) => any;
+    remove: (file: PreviewFile) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onRemove?: (file: PreviewFile) => any;
     onDownload?: (file: PreviewFile) => any;
+    onRemove?: (file: PreviewFile) => any;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/components/shared/BaseBreadcrumb.vue.d.ts

@@ -1,9 +1,10 @@
 import type { PropType } from 'vue';
+import type { RouteLocationRaw } from 'vue-router';
 type Breadcrumb = {
     title: string;
     disabled?: boolean;
     href?: string;
-    to?: any;
+    to?: RouteLocationRaw;
 };
 declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     title: StringConstructor;

package/dist/components/shared/BaseIcon.vue.d.ts

@@ -1,4 +1,5 @@
 import { type Component, type PropType } from 'vue';
+import type { UiSemanticIconName } from '../../platform/types';
 declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     icon: {
         type: PropType<string | Component>;
@@ -12,6 +13,7 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
         type: FunctionConstructor;
         required: false;
     };
+    semantic: PropType<UiSemanticIconName>;
     rowData: ObjectConstructor;
     ariaLabel: StringConstructor;
     interactive: {
@@ -34,6 +36,7 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
         type: FunctionConstructor;
         required: false;
     };
+    semantic: PropType<UiSemanticIconName>;
     rowData: ObjectConstructor;
     ariaLabel: StringConstructor;
     interactive: {

package/dist/components/shared/ConfirmDialog.vue.d.ts

@@ -14,19 +14,19 @@ type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_26) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    "update:modelValue": (value: boolean) => any;
     confirm: () => any;
     cancel: () => any;
+    "update:modelValue": (value: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:modelValue"?: (value: boolean) => any;
     onConfirm?: () => any;
     onCancel?: () => any;
+    "onUpdate:modelValue"?: (value: boolean) => any;
 }>, {
-    title: string;
+    loading: boolean;
     color: string;
     width: string | number;
-    loading: boolean;
     message: string;
+    title: string;
     confirmText: string;
     cancelText: string;
     persistent: boolean;

package/dist/components/shared/DownloadButton.vue.d.ts

@@ -9,15 +9,15 @@ interface Props {
 }
 declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     error: (error: Error) => any;
-    download: (url: string) => any;
     success: (filename: string) => any;
+    download: (url: string) => any;
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
     onError?: (error: Error) => any;
-    onDownload?: (url: string) => any;
     onSuccess?: (filename: string) => any;
+    onDownload?: (url: string) => any;
 }>, {
-    title: string;
     method: "anchor" | "fetch";
+    title: string;
     iconStart: boolean;
     iconEnd: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/components/shared/MoneyInput.vue.d.ts

@@ -109,11 +109,11 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
 }>> & Readonly<{
     "onUpdate:modelValue"?: (...args: any[]) => any;
 }>, {
+    max: number;
+    min: number;
     variant: string;
     disabled: boolean;
     label: string;
-    max: number;
-    min: number;
     modelValue: number;
     readonly: boolean;
     clearable: boolean;

package/dist/components/shared/PdfViewer.vue.d.ts

@@ -31,22 +31,23 @@ declare const __VLS_export: import("vue").DefineComponent<Props, {
     printPdf: () => void;
     toggleFullscreen: () => void;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    close: () => any;
     error: (error: string) => any;
-    load: (pdf: any) => any;
+    close: () => any;
     download: (url: string) => any;
+    print: (url: string) => any;
+    load: (pdf: any) => any;
     pageChange: (page: number) => any;
     zoomChange: (zoom: number) => any;
-    print: (url: string) => any;
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
-    onClose?: () => any;
     onError?: (error: string) => any;
-    onLoad?: (pdf: any) => any;
+    onClose?: () => any;
     onDownload?: (url: string) => any;
+    onPrint?: (url: string) => any;
+    onLoad?: (pdf: any) => any;
     onPageChange?: (page: number) => any;
     onZoomChange?: (zoom: number) => any;
-    onPrint?: (url: string) => any;
 }>, {
+    errorTitle: string;
     loadingText: string;
     showHeader: boolean;
     showFooter: boolean;
@@ -56,7 +57,6 @@ declare const __VLS_export: import("vue").DefineComponent<Props, {
     showPrint: boolean;
     showFullscreen: boolean;
     showClose: boolean;
-    errorTitle: string;
     initialZoom: number;
     minZoom: number;
     maxZoom: number;

package/dist/components/shared/ShamsiDatePicker.vue.d.ts

@@ -27,11 +27,11 @@ declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {},
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
     "onUpdate:modelValue"?: (value: string | [string, string]) => any;
 }>, {
-    type: PickerType;
     color: string;
+    type: PickerType;
+    mode: "single" | "range";
     disabled: boolean;
     label: string;
-    mode: "single" | "range";
     modelValue: string | [string, string] | null;
     clearable: boolean;
     placeholder: string;

package/dist/components/shared/data-table-v2/CustomDataTableV2.vue.d.ts

@@ -9,15 +9,19 @@ interface Props extends Omit<DataTableProps, 'routes' | 'filters'> {
     filters?: Record<string, any>;
     /** Load next page when scrolling near the bottom (requires showPagination) */
     enableInfiniteScroll?: boolean;
+    /** Shows a settings menu that lets the user toggle data columns. */
+    settings?: boolean;
+    /** Controlled list of visible data-column keys. Omit to keep all columns visible. */
+    visibleColumns?: string[];
 }
-declare var __VLS_156: {
+declare var __VLS_261: {
     applyFilter: () => void;
     resetFilter: () => void;
     hasActiveFilters: boolean;
     filterModel: Record<string, any>;
 };
 type __VLS_Slots = {} & {
-    'inline-filter-actions'?: (props: typeof __VLS_156) => any;
+    'inline-filter-actions'?: (props: typeof __VLS_261) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<Props, {
     fetchData: (queryParams?: Record<string, unknown>) => Promise<void>;
@@ -49,9 +53,15 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     "update:selectedItems": (items: TableItem[]) => any;
     "selection-change": (items: TableItem[]) => any;
+    "update:visibleColumns": (keys: string[]) => any;
+    "column-visibility-change": (keys: string[]) => any;
+    "page-size-change": (size: number) => any;
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
     "onUpdate:selectedItems"?: (items: TableItem[]) => any;
     "onSelection-change"?: (items: TableItem[]) => any;
+    "onUpdate:visibleColumns"?: (keys: string[]) => any;
+    "onColumn-visibility-change"?: (keys: string[]) => any;
+    "onPage-size-change"?: (size: number) => any;
 }>, {
     items: TableItem[];
     selectable: boolean;
@@ -73,6 +83,7 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {
     exportUrl: string;
     exportFileName: string;
     enableInfiniteScroll: boolean;
+    settings: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/components/shared/data-table-v2/types.d.ts

@@ -17,6 +17,10 @@ export interface DataTableV2Props extends Omit<DataTableProps, 'routes' | 'filte
     filters?: Record<string, any>;
     /** Enable infinite scroll when paginating (loads next page near bottom) */
     enableInfiniteScroll?: boolean;
+    /** Show the end-user column visibility settings menu. */
+    settings?: boolean;
+    /** Controlled list of visible data-column keys. */
+    visibleColumns?: string[];
     axiosInstance?: AxiosInstance;
 }
 export interface DataTableV2Context {

package/dist/components/state/UiAsyncState.vue.d.ts

@@ -0,0 +1,33 @@
+import { type UiAsyncStatus } from '../../platform/types';
+type __VLS_Props = {
+    status: UiAsyncStatus;
+};
+declare var __VLS_1: {}, __VLS_8: {}, __VLS_15: {
+    retry: () => void;
+}, __VLS_24: {}, __VLS_31: {
+    status: "idle" | "loading" | "error" | "success";
+};
+type __VLS_Slots = {} & {
+    loading?: (props: typeof __VLS_1) => any;
+} & {
+    empty?: (props: typeof __VLS_8) => any;
+} & {
+    error?: (props: typeof __VLS_15) => any;
+} & {
+    'permission-denied'?: (props: typeof __VLS_24) => any;
+} & {
+    default?: (props: typeof __VLS_31) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    retry: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onRetry?: () => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/state/UiEmptyState.vue.d.ts

@@ -0,0 +1,34 @@
+type __VLS_Props = {
+    title?: string;
+    description?: string;
+    variant?: 'compact' | 'full';
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+    primaryLabel?: string;
+    secondaryLabel?: string;
+};
+declare var __VLS_1: {}, __VLS_8: {}, __VLS_16: {};
+type __VLS_Slots = {} & {
+    icon?: (props: typeof __VLS_1) => any;
+} & {
+    default?: (props: typeof __VLS_8) => any;
+} & {
+    actions?: (props: typeof __VLS_16) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    primary: () => any;
+    secondary: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onPrimary?: () => any;
+    onSecondary?: () => any;
+}>, {
+    variant: "compact" | "full";
+    headingLevel: 2 | 3 | 4 | 5 | 6;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};