@abpjs/theme-shared 3.0.0 → 3.1.0

package/dist/handlers/error.handler.d.ts

@@ -44,6 +44,37 @@ export interface ErrorHandler {
     /** Clear the current error component */
     clearErrorComponent: () => void;
 }
+/**
+ * Default error messages for common HTTP status codes.
+ */
+export declare const DEFAULT_ERROR_MESSAGES: Record<number, string>;
+/**
+ * Default error localizations with title and details.
+ * These are the localization keys used for error messages.
+ * @since 3.1.0
+ */
+export declare const DEFAULT_ERROR_LOCALIZATIONS: {
+    readonly defaultError: {
+        readonly title: "AbpUi::DefaultErrorMessage";
+        readonly details: "AbpUi::DefaultErrorMessageDetail";
+    };
+    readonly defaultError401: {
+        readonly title: "AbpUi::DefaultErrorMessage401";
+        readonly details: "AbpUi::DefaultErrorMessage401Detail";
+    };
+    readonly defaultError403: {
+        readonly title: "AbpUi::DefaultErrorMessage403";
+        readonly details: "AbpUi::DefaultErrorMessage403Detail";
+    };
+    readonly defaultError404: {
+        readonly title: "AbpUi::DefaultErrorMessage404";
+        readonly details: "AbpUi::DefaultErrorMessage404Detail";
+    };
+    readonly defaultError500: {
+        readonly title: "AbpUi::DefaultErrorMessage500";
+        readonly details: "AbpUi::DefaultErrorMessage500Detail";
+    };
+};
 export interface UseErrorHandlerOptions {
     /**
      * Custom navigate function. If not provided, navigation to login will be a no-op.

package/dist/index.js

@@ -42,6 +42,8 @@ __export(index_exports, {
   Confirmation: () => Confirmation,
   ConfirmationDialog: () => ConfirmationDialog,
   ConfirmationProvider: () => ConfirmationProvider,
+  DEFAULT_ERROR_LOCALIZATIONS: () => DEFAULT_ERROR_LOCALIZATIONS,
+  DEFAULT_ERROR_MESSAGES: () => DEFAULT_ERROR_MESSAGES,
   DEFAULT_LAZY_STYLES: () => DEFAULT_LAZY_STYLES,
   DEFAULT_STYLES: () => DEFAULT_STYLES,
   ErrorComponent: () => ErrorComponent,
@@ -57,6 +59,7 @@ __export(index_exports, {
   ModalFooter: () => AbpModalFooter,
   ModalHeader: () => AbpModalHeader,
   ModalProvider: () => ModalProvider,
+  NavItem: () => NavItem,
   NavItemsService: () => NavItemsService,
   PASSWORD_SETTING_KEYS: () => PASSWORD_SETTING_KEYS,
   Profile: () => Profile,
@@ -115,6 +118,24 @@ var Confirmation;
   })(Status = Confirmation2.Status || (Confirmation2.Status = {}));
 })(Confirmation || (Confirmation = {}));
 
+// src/models/nav-item.ts
+var NavItem = class {
+  /**
+   * Create a new NavItem.
+   * @param props - Partial properties to initialize the nav item
+   * @since 3.1.0
+   */
+  constructor(props) {
+    this.id = props.id ?? "";
+    this.component = props.component;
+    this.html = props.html;
+    this.action = props.action;
+    this.order = props.order;
+    this.requiredPolicy = props.requiredPolicy;
+    this.visible = props.visible;
+  }
+};
+
 // src/constants/styles.ts
 var BOOTSTRAP = "bootstrap-{{dir}}.min.css";
 var DEFAULT_STYLES = `
@@ -652,6 +673,28 @@ var DEFAULT_ERROR_MESSAGES = {
   500: "AbpUi::DefaultErrorMessage500",
   503: "AbpUi::DefaultErrorMessage503"
 };
+var DEFAULT_ERROR_LOCALIZATIONS = {
+  defaultError: {
+    title: "AbpUi::DefaultErrorMessage",
+    details: "AbpUi::DefaultErrorMessageDetail"
+  },
+  defaultError401: {
+    title: "AbpUi::DefaultErrorMessage401",
+    details: "AbpUi::DefaultErrorMessage401Detail"
+  },
+  defaultError403: {
+    title: "AbpUi::DefaultErrorMessage403",
+    details: "AbpUi::DefaultErrorMessage403Detail"
+  },
+  defaultError404: {
+    title: "AbpUi::DefaultErrorMessage404",
+    details: "AbpUi::DefaultErrorMessage404Detail"
+  },
+  defaultError500: {
+    title: "AbpUi::DefaultErrorMessage500",
+    details: "AbpUi::DefaultErrorMessage500Detail"
+  }
+};
 function useErrorHandler(options = {}) {
   const { navigate, loginPath = "/account/login" } = options;
   const confirmation = useConfirmation();
@@ -791,13 +834,14 @@ var _NavItemsService = class _NavItemsService {
    * Add one or more items.
    * Items are automatically sorted by order.
    *
-   * @param items - Array of items to add
+   * @param newItems - Array of items to add
    * @since 3.0.0
+   * @since 3.1.0 - Renamed parameter from items to newItems
    */
-  addItems(items) {
+  addItems(newItems) {
     const existingIds = new Set(this._items.map((item) => item.id));
-    const newItems = items.filter((item) => !existingIds.has(item.id));
-    this._items = [...this._items, ...newItems];
+    const itemsToAdd = newItems.filter((item) => !existingIds.has(item.id)).map((item) => item instanceof NavItem ? item : new NavItem(item));
+    this._items = [...this._items, ...itemsToAdd];
     this.notify();
   }
   /**
@@ -2545,6 +2589,8 @@ function getPasswordValidationRules(store) {
   Confirmation,
   ConfirmationDialog,
   ConfirmationProvider,
+  DEFAULT_ERROR_LOCALIZATIONS,
+  DEFAULT_ERROR_MESSAGES,
   DEFAULT_LAZY_STYLES,
   DEFAULT_STYLES,
   ErrorComponent,
@@ -2560,6 +2606,7 @@ function getPasswordValidationRules(store) {
   ModalFooter,
   ModalHeader,
   ModalProvider,
+  NavItem,
   NavItemsService,
   PASSWORD_SETTING_KEYS,
   Profile,

package/dist/index.mjs

@@ -9,6 +9,24 @@ var Confirmation;
   })(Status = Confirmation2.Status || (Confirmation2.Status = {}));
 })(Confirmation || (Confirmation = {}));
 
+// src/models/nav-item.ts
+var NavItem = class {
+  /**
+   * Create a new NavItem.
+   * @param props - Partial properties to initialize the nav item
+   * @since 3.1.0
+   */
+  constructor(props) {
+    this.id = props.id ?? "";
+    this.component = props.component;
+    this.html = props.html;
+    this.action = props.action;
+    this.order = props.order;
+    this.requiredPolicy = props.requiredPolicy;
+    this.visible = props.visible;
+  }
+};
+
 // src/constants/styles.ts
 var BOOTSTRAP = "bootstrap-{{dir}}.min.css";
 var DEFAULT_STYLES = `
@@ -569,6 +587,28 @@ var DEFAULT_ERROR_MESSAGES = {
   500: "AbpUi::DefaultErrorMessage500",
   503: "AbpUi::DefaultErrorMessage503"
 };
+var DEFAULT_ERROR_LOCALIZATIONS = {
+  defaultError: {
+    title: "AbpUi::DefaultErrorMessage",
+    details: "AbpUi::DefaultErrorMessageDetail"
+  },
+  defaultError401: {
+    title: "AbpUi::DefaultErrorMessage401",
+    details: "AbpUi::DefaultErrorMessage401Detail"
+  },
+  defaultError403: {
+    title: "AbpUi::DefaultErrorMessage403",
+    details: "AbpUi::DefaultErrorMessage403Detail"
+  },
+  defaultError404: {
+    title: "AbpUi::DefaultErrorMessage404",
+    details: "AbpUi::DefaultErrorMessage404Detail"
+  },
+  defaultError500: {
+    title: "AbpUi::DefaultErrorMessage500",
+    details: "AbpUi::DefaultErrorMessage500Detail"
+  }
+};
 function useErrorHandler(options = {}) {
   const { navigate, loginPath = "/account/login" } = options;
   const confirmation = useConfirmation();
@@ -708,13 +748,14 @@ var _NavItemsService = class _NavItemsService {
    * Add one or more items.
    * Items are automatically sorted by order.
    *
-   * @param items - Array of items to add
+   * @param newItems - Array of items to add
    * @since 3.0.0
+   * @since 3.1.0 - Renamed parameter from items to newItems
    */
-  addItems(items) {
+  addItems(newItems) {
     const existingIds = new Set(this._items.map((item) => item.id));
-    const newItems = items.filter((item) => !existingIds.has(item.id));
-    this._items = [...this._items, ...newItems];
+    const itemsToAdd = newItems.filter((item) => !existingIds.has(item.id)).map((item) => item instanceof NavItem ? item : new NavItem(item));
+    this._items = [...this._items, ...itemsToAdd];
     this.notify();
   }
   /**
@@ -2507,6 +2548,8 @@ export {
   Confirmation,
   ConfirmationDialog,
   ConfirmationProvider,
+  DEFAULT_ERROR_LOCALIZATIONS,
+  DEFAULT_ERROR_MESSAGES,
   DEFAULT_LAZY_STYLES,
   DEFAULT_STYLES,
   ErrorComponent,
@@ -2522,6 +2565,7 @@ export {
   AbpModalFooter as ModalFooter,
   AbpModalHeader as ModalHeader,
   ModalProvider,
+  NavItem,
   NavItemsService,
   PASSWORD_SETTING_KEYS,
   Profile,

package/dist/models/nav-item.d.ts

@@ -1,15 +1,54 @@
 /**
  * Nav Item Model
- * Translated from @abp/ng.theme.shared/lib/models/nav-item.ts v3.0.0
+ * Translated from @abp/ng.theme.shared/lib/models/nav-item.ts v3.1.0
  *
  * @since 3.0.0 - Added id property, changed permission to requiredPolicy
+ * @since 3.1.0 - Changed from interface to class, added visible callback
  */
 import type { ComponentType } from 'react';
 /**
- * Navigation item configuration.
+ * Navigation item properties interface.
+ * @since 3.1.0
+ */
+export interface NavItemProps {
+    /**
+     * Unique identifier for the nav item.
+     * @since 3.0.0
+     */
+    id: string | number;
+    /**
+     * React component to render for this nav item.
+     */
+    component?: ComponentType<any>;
+    /**
+     * Raw HTML string to render (use with caution for XSS).
+     */
+    html?: string;
+    /**
+     * Action to execute when the nav item is clicked.
+     */
+    action?: () => void;
+    /**
+     * Order for sorting nav items. Lower numbers appear first.
+     */
+    order?: number;
+    /**
+     * Required policy to show this nav item.
+     * @since 3.0.0 - Renamed from permission
+     */
+    requiredPolicy?: string;
+    /**
+     * Callback to determine visibility of the nav item.
+     * @since 3.1.0
+     */
+    visible?: () => boolean;
+}
+/**
+ * Navigation item class.
  * @since 3.0.0 - Added id property, changed permission to requiredPolicy
+ * @since 3.1.0 - Changed from interface to class, added visible callback
  */
-export interface NavItem {
+export declare class NavItem implements NavItemProps {
     /**
      * Unique identifier for the nav item.
      * @since 3.0.0
@@ -36,4 +75,15 @@ export interface NavItem {
      * @since 3.0.0 - Renamed from permission
      */
     requiredPolicy?: string;
+    /**
+     * Callback to determine visibility of the nav item.
+     * @since 3.1.0
+     */
+    visible?: () => boolean;
+    /**
+     * Create a new NavItem.
+     * @param props - Partial properties to initialize the nav item
+     * @since 3.1.0
+     */
+    constructor(props: Partial<NavItemProps>);
 }

package/dist/services/nav-items.service.d.ts

@@ -1,13 +1,14 @@
 /**
  * Nav Items Service
- * Translated from @abp/ng.theme.shared/lib/services/nav-items.service.ts v3.0.0
+ * Translated from @abp/ng.theme.shared/lib/services/nav-items.service.ts v3.1.0
  *
  * Provides a service-based approach to managing navigation items,
  * replacing the utility functions approach from v2.9.0.
  *
  * @since 3.0.0
+ * @since 3.1.0 - Updated addItems parameter name to newItems for clarity
  */
-import type { NavItem } from '../models/nav-item';
+import { NavItem, NavItemProps } from '../models/nav-item';
 /**
  * NavItemsService manages navigation items with reactive updates.
  * This is a singleton service that provides methods to add, remove, and patch nav items.
@@ -80,10 +81,11 @@ export declare class NavItemsService {
      * Add one or more items.
      * Items are automatically sorted by order.
      *
-     * @param items - Array of items to add
+     * @param newItems - Array of items to add
      * @since 3.0.0
+     * @since 3.1.0 - Renamed parameter from items to newItems
      */
-    addItems(items: NavItem[]): void;
+    addItems(newItems: (NavItem | NavItemProps)[]): void;
     /**
      * Remove an item by id.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abpjs/theme-shared",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "ABP Framework Theme Shared components for React - translated from @abp/ng.theme.shared",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -27,10 +27,10 @@
     "next-themes": "^0.4.6",
     "react-hook-form": "^7.48.0",
     "react-icons": "^5.5.0",
-    "@abpjs/core": "3.0.0"
+    "@abpjs/core": "3.1.0"
   },
   "devDependencies": {
-    "@abp/ng.theme.shared": "3.0.0",
+    "@abp/ng.theme.shared": "3.1.0",
     "@vitest/coverage-v8": "^1.6.0",
     "vitest": "^1.6.0"
   },