@memberjunction/ng-user-view-properties 2.43.0 → 2.44.0

package/README.md

@@ -25,7 +25,20 @@ This library has the following peer dependencies:
 - @memberjunction/core
 - @memberjunction/global
 - @memberjunction/core-entities
-- Multiple Kendo UI Angular components (Dialog, Layout, Inputs, etc.)
+- @memberjunction/ng-base-forms
+- @memberjunction/ng-find-record
+- @memberjunction/ng-resource-permissions
+- @memberjunction/ng-shared
+- @memberjunction/ng-tabstrip
+- Multiple Kendo UI Angular components:
+  - @progress/kendo-angular-sortable
+  - @progress/kendo-angular-dialog
+  - @progress/kendo-angular-layout
+  - @progress/kendo-angular-inputs
+  - @progress/kendo-angular-buttons
+  - @progress/kendo-angular-filter
+  - @progress/kendo-angular-dropdowns
+  - @progress/kendo-data-query
 
 ## Usage
 
@@ -72,6 +85,10 @@ createCategorizedView() {
 
 ## API Reference
 
+### Component Class: UserViewPropertiesDialogComponent
+
+Extends `BaseFormComponent` from @memberjunction/ng-base-forms.
+
 ### Inputs
 
 | Input                 | Type               | Description                                            |
@@ -95,18 +112,33 @@ createCategorizedView() {
 | CreateViewInCategory   | entityName: string, viewCategoryID: string | void | Creates a view in a specific category     |
 | Open                   | ViewID?: string                  | void      | Opens the dialog for editing an existing view   |
 | saveProperties         | -                                | Promise<void> | Saves the current view properties           |
+| closePropertiesDialog  | -                                | void      | Closes the dialog and emits dialogClosed event |
+| Load                   | -                                | Promise<void> | Loads view data from database or creates new record |
+| toggleColumn           | column: any                      | Promise<void> | Toggles visibility of a column in the view |
+| onDragEnd              | e: DragEndEvent                  | void      | Handles field reordering via drag and drop     |
+| addSort                | -                                | void      | Adds a new sort field to the view              |
+| removeSort             | item: any                        | void      | Removes a sort field from the view             |
 
 ## Component Structure
 
 The dialog consists of six tabbed sections:
 
 1. **General**: Basic view properties (name and description)
-2. **Fields**: Configure visible fields and their order
+2. **Fields**: Configure visible fields and their order using drag-and-drop
 3. **Filters**: Set up filtering using either Smart Filters or standard filters
-4. **Sorting**: Define multi-field sorting with direction control
+4. **Sorting**: Define multi-field sorting with direction control (asc/desc)
 5. **Sharing**: Manage view permissions using ResourcePermissions
 6. **Advanced**: Access to SQL WHERE clauses and Smart Filter explanations
 
+### Key Features
+
+- **Drag-and-Drop Field Ordering**: Uses Kendo SortableComponent for field reordering
+- **Smart Filter Support**: Natural language filtering with view/list references
+- **Permission-Based Editing**: Respects user permissions via UserCanEdit property
+- **Keyboard Support**: Enter key saves changes (except in textareas)
+- **Auto-Navigation**: After creating a new view, automatically navigates to it
+- **Event Broadcasting**: Emits ViewUpdated events through MJGlobal event system
+
 ## Examples
 
 ### Complete Integration Example
@@ -166,4 +198,19 @@ Smart Filters allow users to describe filtering requirements in natural language
 - The component integrates with the MemberJunction metadata system for field information
 - Permissions are automatically enforced via the `UserCanEdit` property
 - The dialog automatically adjusts for window resizing
-- Changes are not applied until the user clicks Save
+- Changes are not applied until the user clicks Save
+- The component uses UserViewEntityExtended for enhanced view functionality
+- Grid state and filter state are stored as JSON strings in the database
+- Sort state supports both legacy numeric (1/2) and modern string ('asc'/'desc') formats
+- The dialog is moved to document body for proper z-index stacking
+
+## Build Instructions
+
+To build this package:
+
+```bash
+cd packages/Angular/Explorer/user-view-properties
+npm run build
+```
+
+This will compile the TypeScript and generate the distribution files in the `dist` folder.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/ng-user-view-properties",
-  "version": "2.43.0",
+  "version": "2.44.0",
   "description": "MemberJunction: Angular UI Dialog Component to View/Edit User View Properties",
   "main": "./dist/public-api.js",
   "typings": "./dist/public-api.d.ts",
@@ -24,13 +24,13 @@
     "@angular/forms": "18.0.2"
   },
   "dependencies": {
-    "@memberjunction/global": "2.43.0",
-    "@memberjunction/core": "2.43.0",
-    "@memberjunction/core-entities": "2.43.0",
-    "@memberjunction/ng-base-forms": "2.43.0",
-    "@memberjunction/ng-find-record": "2.43.0",
-    "@memberjunction/ng-resource-permissions": "2.43.0",
-    "@memberjunction/ng-shared": "2.43.0",
+    "@memberjunction/global": "2.44.0",
+    "@memberjunction/core": "2.44.0",
+    "@memberjunction/core-entities": "2.44.0",
+    "@memberjunction/ng-base-forms": "2.44.0",
+    "@memberjunction/ng-find-record": "2.44.0",
+    "@memberjunction/ng-resource-permissions": "2.44.0",
+    "@memberjunction/ng-shared": "2.44.0",
     "@progress/kendo-angular-sortable": "16.2.0",
     "@progress/kendo-angular-dialog": "16.2.0",
     "@progress/kendo-angular-layout": "16.2.0",