cat-documents-ng 0.2.87 → 0.2.89

package/README.md

@@ -320,3 +320,102 @@ folderBlocks: Data sourced from FOLDERPANEL for folder blocks.
 
 ## Additional Resources
 For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.
+
+## Troubleshooting
+
+### Confirmation Dialog Not Visible
+
+If you experience issues where confirmation dialogs are not visible when the library is installed in your project, this is likely due to z-index conflicts. Here are the solutions:
+
+#### Solution 1: Import Global Styles
+
+Import the library's global styles in your main `styles.scss` or `angular.json`:
+
+```scss
+// In your styles.scss
+@import '~cat-document-lib/lib/styles.scss';
+```
+
+#### Solution 2: Configure Z-Index in angular.json
+
+Add the library's styles to your `angular.json` file:
+
+```json
+{
+  "projects": {
+    "your-project": {
+      "architect": {
+        "build": {
+          "options": {
+            "styles": [
+              "src/styles.scss",
+              "node_modules/cat-document-lib/lib/styles.scss"
+            ]
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+#### Solution 3: Override Z-Index in Host Project
+
+If the above solutions don't work, you can override the z-index values in your host project's CSS:
+
+```scss
+/* Ensure confirmation dialogs are visible */
+.p-confirm-dialog {
+  z-index: 10001 !important;
+}
+
+.p-dialog-mask {
+  z-index: 10000 !important;
+}
+
+.p-sidebar {
+  z-index: 10000 !important;
+}
+```
+
+#### Solution 4: Use Higher Base Z-Index
+
+When using the sidebar component, you can specify a higher base z-index:
+
+```html
+<lib-sidebar 
+  [baseZIndex]="20000"
+  [autoZIndex]="false">
+  <!-- content -->
+</lib-sidebar>
+```
+
+### Common Issues
+
+1. **Dialog appears behind other elements**: This is usually a z-index issue. Use Solution 1 or 2 above.
+2. **Sidebar not visible**: Check if the `visible` property is properly bound and the component is not hidden by CSS.
+3. **Confirmation dialog not showing**: Ensure PrimeNG's ConfirmationService is properly configured in your app.
+
+## API Reference
+
+### SidebarComponent
+
+The main sidebar component with the following inputs:
+
+- `visible`: Boolean to control sidebar visibility
+- `position`: 'left' | 'right' - Sidebar position
+- `width`: String for sidebar width
+- `baseZIndex`: Number for z-index (default: 10000)
+- `autoZIndex`: Boolean to auto-manage z-index (default: false)
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests
+5. Submit a pull request
+
+## License
+
+This project is licensed under the MIT License.

package/Shared/constant/SHARED.d.ts

@@ -58,6 +58,10 @@ export declare class SHARED {
      * Represents an empty string.
      */
     static EMPTY: string;
+    /**
+     * Represents an empty string.
+     */
+    static STRING: string;
     /**
      * Represents an true.
      * @static
@@ -228,7 +232,16 @@ export declare class SHARED {
     static UPLOAD_FAILED: string;
     static USER_LIST: string;
     static CATEGORIES: string;
+    static UNSAVED_CHANGES_MESSAGE: string;
+    static UNSAVED_CHANGES_HEADER: string;
     static DOCUMENT_DELETED_SUCCESSFULLY: string;
+    static UNSAVED_CHANGES_ICON: string;
+    static REMOVE: string;
+    static CANCEL: string;
+    static ACCEPT_ICON: string;
+    static REJECT_ICON: string;
+    static ACCEPT_BUTTON_STYLE_CLASS: string;
+    static REJECT_BUTTON_STYLE_CLASS: string;
     static Menu: {
         label: string;
         items: ({