diff --git a/.vscode/settings.json b/.vscode/settings.json
index b459a1878..33b8960cf 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -90,5 +90,8 @@
     "cursor-global": true,
     "cursor-workspace": true
   },
-  "chat.mcp.access": "all"
+  "chat.mcp.access": "all",
+  "typescript.inlayHints.parameterTypes.enabled": true,
+  "typescript.inlayHints.variableTypes.enabled": true,
+  "editor.hover.delay": 100
 }
diff --git a/CLAUDE.md b/CLAUDE.md
index cdd8d1116..3d7569609 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -274,6 +274,8 @@ npx nx affected:test
 - **E2E Testing Requirements**: Always include `data-what`, `data-which`, and dynamic `data-*` attributes in HTML templates - these are essential for automated testing by QA colleagues
 
 ### Library Development Patterns
+- **Understanding Internal Libraries**: Before using any internal library from the `libs/` directory, always read its README.md file first to understand its purpose, API, and proper usage patterns
+- **Library Documentation**: All libraries have comprehensive README.md documentation. To prevent context pollution, **always use a subagent** (preferably `docs-architect` or `general-purpose`) to retrieve specific information from library documentation rather than reading the entire file directly
 - **New Library Creation**: Use Nx generators with domain-specific naming (`[domain]-[layer]-[feature]`)
 - **Standalone Components**: All new components must be standalone with explicit imports - no more NgModules
 - **Testing Framework Selection**:
@@ -281,6 +283,96 @@ npx nx affected:test
   - **Existing libraries**: Continue with Jest + Spectator until migrated
 - **Path Aliases**: Always use `@isa/[domain]/[layer]/[feature]` - avoid relative imports across domain boundaries
 
+#### Library Reference Guide
+
+All 62 libraries in the monorepo have comprehensive README.md documentation. Use subagents to retrieve specific information from these READMEs to avoid context pollution.
+
+**Availability Domain (1 library)**
+- `@isa/availability/data-access` - Product availability service supporting 6 order types (InStore, Pickup, Delivery, DIG-Versand, B2B-Versand, Download) with intelligent routing, Zod validation, and business rule enforcement
+
+**Catalogue Domain (1 library)**
+- `@isa/catalogue/data-access` - Product search and availability validation service with multi-type search (EAN, Term, Loyalty), download validation, and DIG/B2B delivery availability
+
+**Checkout Domain (6 libraries)**
+- `@isa/checkout/data-access` - Shopping cart management and checkout orchestration supporting 6 order types with reward system integration, payment type logic, and CRM data transformation
+- `@isa/checkout/feature/reward-order-confirmation` - Order confirmation page for reward/premium orders with address display and item list
+- `@isa/checkout/feature/reward-shopping-cart` - Complete reward shopping cart feature with checkout workflow, item management, and order completion orchestration
+- `@isa/checkout/feature/reward-catalog` - Reward catalog browsing with customer bonus points, filtering, pagination, and item selection
+- `@isa/checkout/shared/product-info` - Product information display components for checkout (redemption info, destination info, stock info)
+- `@isa/checkout/shared/reward-selection-dialog` - Product selection dialog for adding items to reward shopping cart
+
+**Common Libraries (3 libraries)**
+- `@isa/common/data-access` - Foundational data access utilities including error hierarchy, custom RxJS operators (takeUntilAborted, takeUntilKeydown), batching infrastructure, and Zod integration
+- `@isa/common/decorators` - TypeScript decorators for validation (ValidateParams), caching (Cache), debouncing (Debounce), and in-flight request management (InFlight, InFlightWithKey, InFlightWithCache)
+- `@isa/common/print` - Platform-aware print service supporting both label and office printers with smart printer selection and reusable print dialog components
+
+**Core Libraries (5 libraries)**
+- `@isa/core/config` - Type-safe configuration management with runtime Zod validation, nested object access via dot notation, and environment-specific configuration
+- `@isa/core/logging` - Centralized logging service with log levels, contextual information, and Angular integration
+- `@isa/core/navigation` - Context preservation service for multi-step navigation flows with automatic tab-scoped storage and cleanup
+- `@isa/core/storage` - User storage abstraction with SessionStorage/IndexedDB backends and automatic serialization
+- `@isa/core/tabs` - Tab management system with NgRx Signals, persistent storage, intelligent history pruning, and Router integration
+
+**CRM Domain (1 library)**
+- `@isa/crm/data-access` - Customer relationship management data access with customer fetching, shipping address management, bonus cards, payer info, and tab-based state management
+
+**Icons (1 library)**
+- `@isa/icons` - Icon library with Angular icon components and SVG assets
+
+**OMS Domain (9 libraries)**
+- `@isa/oms/data-access` - Order Management System data access with return search, question-based workflows, state management (3 stores), and print integration
+- `@isa/oms/feature/return-details` - Receipt details view with item display, customer history, quantity management, and return eligibility validation
+- `@isa/oms/feature/return-process` - Dynamic question-based return process with 6 product categories, 5 question types, form validation, and state persistence
+- `@isa/oms/feature/return-review` - Final review step for return process with task summary, receipt reprinting, and navigation protection
+- `@isa/oms/feature/return-search` - Return search with filtering, pagination, infinite scroll, and automatic redirect to details when single result found
+- `@isa/oms/feature/return-summary` - Pre-submission summary of return process with item review and final confirmation before order creation
+- `@isa/oms/shared/product-info` - Product display component for OMS workflows with image, navigation, and format icons
+- `@isa/oms/shared/task-list` - Task list component with dual appearance modes (main/review), NgRx integration, and tab-based isolation
+- `@isa/oms/utils/translation` - Receipt type translation utility with 13 German translations and dependency injection support
+
+**Remission Domain (8 libraries)**
+- `@isa/remission/data-access` - Remission/returns management data access supporting Pflichtremission (mandatory) and Abteilungsremission (department overflow) with stock batching, state management, and supplier/branch services
+- `@isa/remission/feature/remission-list` - Main remission list with dual types, filtering, search, and resource-based data fetching
+- `@isa/remission/feature/remission-return-receipt-details` - Receipt details view with items, metadata, and action integration
+- `@isa/remission/feature/remission-return-receipt-list` - List view for all return receipts with sorting, filtering, and parallel resource fetching
+- `@isa/remission/shared/product` - Product display components for remission workflows (info, stock info, shelf meta)
+- `@isa/remission/shared/remission-start-dialog` - Two-step dialog for receipt creation and package assignment
+- `@isa/remission/shared/return-receipt-actions` - Action components for receipt deletion, continuation, and completion
+- `@isa/remission/shared/search-item-to-remit-dialog` - Dialog for adding unlisted items to remission with search-to-remit flow
+
+**Shared Component Libraries (7 libraries)**
+- `@isa/shared/address` - Address display components (multi-line and inline) with country name resolution and German address special handling
+- `@isa/shared/filter` - Advanced filtering system with filter groups, date ranges, search, and scanner integration
+- `@isa/shared/product-format` - Product format display with icon and text components supporting 6 format codes (HC, PB, EB, AB, DIG, AUD)
+- `@isa/shared/product-image` - Product image directive with CDN integration, configurable dimensions, and lazy loading
+- `@isa/shared/product-router-link` - EAN-based product navigation directive with pluggable URL builder pattern
+- `@isa/shared/quantity-control` - Accessible quantity selector with dropdown presets, manual input mode, and smart logic
+- `@isa/shared/scanner` - Barcode scanner integration with camera and keyboard input support
+
+**UI Component Libraries (17 libraries)**
+- `@isa/ui/bullet-list` - Bullet list component with parent-child icon inheritance and signal-based reactivity
+- `@isa/ui/buttons` - Five button components (Button, TextButton, IconButton, InfoButton, StatefulButton) with pending states, size/color variants, and ARIA support
+- `@isa/ui/datepicker` - Range datepicker with validators, calendar views, and ControlValueAccessor integration
+- `@isa/ui/dialog` - Dialog system with 5 preset types (message, confirmation, text-input, number-input, feedback) and injection-based API
+- `@isa/ui/empty-state` - Empty state component with 4 appearance variants (general, no-results, no-data, error) and SVG icons
+- `@isa/ui/expandable` - Expandable/collapsible container with smooth animations
+- `@isa/ui/input-controls` - Form control components (checkbox, dropdown, text-field, chips, checklist, listbox, inline-input) with ControlValueAccessor integration
+- `@isa/ui/item-rows` - Item display rows with data components and directive-based composition
+- `@isa/ui/label` - Label component with Tag/Notice types and High/Medium/Low priority levels
+- `@isa/ui/layout` - Breakpoint service for responsive design with 4 breakpoints (Tablet, Desktop, DesktopL, DesktopXL)
+- `@isa/ui/menu` - CDK Menu wrapper components with keyboard navigation and ARIA compliance
+- `@isa/ui/progress-bar` - Determinate and indeterminate progress indicators with computed width
+- `@isa/ui/search-bar` - Search bar with clear button, Angular Forms integration, and focus management
+- `@isa/ui/skeleton-loader` - Loading state component with structural directive and customizable dimensions
+- `@isa/ui/toolbar` - Toolbar component with two size variants (small/medium) and content projection
+- `@isa/ui/tooltip` - Tooltip directive with positioning and accessibility
+- `@isa/ui/bullet-list` - Bullet list component with customizable icons and nested list support
+
+**Utility Libraries (3 libraries)**
+- `@isa/utils/ean-validation` - EAN barcode validation with Angular Forms validator, standalone validation function, and comprehensive GS1 prefix reference
+- `@isa/utils/scroll-position` - Scroll position restoration service with tab-based storage
+- `@isa/utils/z-safe-parse` - Safe Zod parsing utility with automatic fallback and console warnings
+
 ### API Integration Workflow
 - **Swagger Generation**: Run `npm run generate:swagger` to regenerate all 10 API clients when backend changes
 - **Data Services**: Wrap generated API clients in domain-specific data-access services with proper error handling and Zod validation
diff --git a/apps/isa-app/src/app/app-routing.module.ts b/apps/isa-app/src/app/app-routing.module.ts
index 0194676f3..8773428e9 100644
--- a/apps/isa-app/src/app/app-routing.module.ts
+++ b/apps/isa-app/src/app/app-routing.module.ts
@@ -208,6 +208,13 @@ const routes: Routes = [
                 (m) => m.routes,
               ),
           },
+          {
+            path: 'order-confirmation',
+            loadChildren: () =>
+              import('@isa/checkout/feature/reward-order-confirmation').then(
+                (m) => m.routes,
+              ),
+          },
         ],
       },
 
diff --git a/apps/isa-app/src/modal/purchase-options/store/purchase-options.store.ts b/apps/isa-app/src/modal/purchase-options/store/purchase-options.store.ts
index 3fb7d70d4..a337c7e2c 100644
--- a/apps/isa-app/src/modal/purchase-options/store/purchase-options.store.ts
+++ b/apps/isa-app/src/modal/purchase-options/store/purchase-options.store.ts
@@ -1024,15 +1024,15 @@ export class PurchaseOptionsStore extends ComponentStore<PurchaseOptionsState> {
       purchaseOption,
     );
 
-    let promotion: Promotion | null = { value: item.promoPoints };
-    let loyalty: Loyalty | null = null;
+    let promotion: Promotion | undefined = { value: item.promoPoints };
+    let loyalty: Loyalty | undefined = undefined;
     const redemptionPoints: number | null = item.redemptionPoints || null;
 
     // "Lesepunkte einlösen" logic
     // If "Lesepunkte einlösen" is checked and item has redemption points, set price to 0 and remove promotion
     if (this.useRedemptionPoints) {
       // If loyalty is set, we need to remove promotion
-      promotion = null;
+      promotion = undefined;
       // Set loyalty points from item
       loyalty = { value: redemptionPoints };
       // Set price to 0
diff --git a/apps/isa-app/src/page/customer/customer-search/details-main-view/details-main-view-billing-addresses/details-main-view-billing-addresses.component.ts b/apps/isa-app/src/page/customer/customer-search/details-main-view/details-main-view-billing-addresses/details-main-view-billing-addresses.component.ts
index 732f2d9e9..165345c80 100644
--- a/apps/isa-app/src/page/customer/customer-search/details-main-view/details-main-view-billing-addresses/details-main-view-billing-addresses.component.ts
+++ b/apps/isa-app/src/page/customer/customer-search/details-main-view/details-main-view-billing-addresses/details-main-view-billing-addresses.component.ts
@@ -165,7 +165,9 @@ export class DetailsMainViewBillingAddressesComponent
           }
         } else if (this.showCustomerAddress) {
           this._host.setPayer(
-            CustomerAdapter.toPayerFromCustomer(customer as Customer),
+            CustomerAdapter.toPayerFromCustomer(
+              customer as unknown as Customer,
+            ),
           );
         }
       });
diff --git a/apps/isa-app/src/page/customer/customer-search/details-main-view/details-main-view-delivery-addresses/details-main-view-delivery-addresses.component.ts b/apps/isa-app/src/page/customer/customer-search/details-main-view/details-main-view-delivery-addresses/details-main-view-delivery-addresses.component.ts
index da0d9a959..63ab63253 100644
--- a/apps/isa-app/src/page/customer/customer-search/details-main-view/details-main-view-delivery-addresses/details-main-view-delivery-addresses.component.ts
+++ b/apps/isa-app/src/page/customer/customer-search/details-main-view/details-main-view-delivery-addresses/details-main-view-delivery-addresses.component.ts
@@ -189,7 +189,9 @@ export class DetailsMainViewDeliveryAddressesComponent
           );
         } else if (this.showCustomerAddress) {
           this._host.setShippingAddress(
-            ShippingAddressAdapter.fromCustomer(customer as Customer),
+            ShippingAddressAdapter.fromCustomer(
+              customer as unknown as Customer,
+            ),
           );
         }
       });
diff --git a/apps/isa-app/src/page/customer/customer-search/details-main-view/details-main-view.component.ts b/apps/isa-app/src/page/customer/customer-search/details-main-view/details-main-view.component.ts
index dac2d6014..a10f99684 100644
--- a/apps/isa-app/src/page/customer/customer-search/details-main-view/details-main-view.component.ts
+++ b/apps/isa-app/src/page/customer/customer-search/details-main-view/details-main-view.component.ts
@@ -279,7 +279,7 @@ export class CustomerDetailsViewMainComponent
   }
 
   get buyer() {
-    return CustomerAdapter.toBuyer(this.customer as Customer);
+    return CustomerAdapter.toBuyer(this.customer as unknown as Customer);
   }
 
   get payer() {
diff --git a/graph.json b/graph.json
new file mode 100644
index 000000000..99b7c4bc0
--- /dev/null
+++ b/graph.json
@@ -0,0 +1,8399 @@
+{
+  "graph": {
+    "nodes": {
+      "remission-feature-remission-return-receipt-details": {
+        "name": "remission-feature-remission-return-receipt-details",
+        "type": "lib",
+        "data": {
+          "root": "libs/remission/feature/remission-return-receipt-details",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/remission/feature/remission-return-receipt-details",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/remission/feature/remission-return-receipt-details/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../../coverage/libs/remission/feature/remission-return-receipt-details"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "remission-feature-remission-return-receipt-details",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/remission/feature/remission-return-receipt-details/src",
+          "prefix": "remi",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "remission-feature-remission-return-receipt-list": {
+        "name": "remission-feature-remission-return-receipt-list",
+        "type": "lib",
+        "data": {
+          "root": "libs/remission/feature/remission-return-receipt-list",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/remission/feature/remission-return-receipt-list",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/remission/feature/remission-return-receipt-list/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../../coverage/libs/remission/feature/remission-return-receipt-list"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "remission-feature-remission-return-receipt-list",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/remission/feature/remission-return-receipt-list/src",
+          "prefix": "remi",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "remission-shared-search-item-to-remit-dialog": {
+        "name": "remission-shared-search-item-to-remit-dialog",
+        "type": "lib",
+        "data": {
+          "root": "libs/remission/shared/search-item-to-remit-dialog",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/remission/shared/search-item-to-remit-dialog",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/remission/shared/search-item-to-remit-dialog/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../../coverage/libs/remission/shared/search-item-to-remit-dialog"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "remission-shared-search-item-to-remit-dialog",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/remission/shared/search-item-to-remit-dialog/src",
+          "prefix": "remi",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "checkout-feature-reward-order-confirmation": {
+        "name": "checkout-feature-reward-order-confirmation",
+        "type": "lib",
+        "data": {
+          "root": "libs/checkout/feature/reward-order-confirmation",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/checkout/feature/reward-order-confirmation",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/checkout/feature/reward-order-confirmation/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../../coverage/libs/checkout/feature/reward-order-confirmation"
+              },
+              "configurations": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "checkout-feature-reward-order-confirmation",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/checkout/feature/reward-order-confirmation/src",
+          "prefix": "checkout",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "remission-return-receipt-actions": {
+        "name": "remission-return-receipt-actions",
+        "type": "lib",
+        "data": {
+          "root": "libs/remission/shared/return-receipt-actions",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/remission/shared/return-receipt-actions",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/remission/shared/return-receipt-actions/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../../coverage/libs/remission/shared/return-receipt-actions"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "remission-return-receipt-actions",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/remission/shared/return-receipt-actions/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "remission-start-dialog": {
+        "name": "remission-start-dialog",
+        "type": "lib",
+        "data": {
+          "root": "libs/remission/shared/remission-start-dialog",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/remission/shared/remission-start-dialog",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/remission/shared/remission-start-dialog/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../../coverage/libs/remission/shared/remission-start-dialog"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "remission-start-dialog",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/remission/shared/remission-start-dialog/src",
+          "prefix": "remi",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "reward-selection-dialog": {
+        "name": "reward-selection-dialog",
+        "type": "lib",
+        "data": {
+          "root": "libs/checkout/shared/reward-selection-dialog",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/checkout/shared/reward-selection-dialog",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/checkout/shared/reward-selection-dialog/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../../coverage/libs/checkout/shared/reward-selection-dialog"
+              },
+              "configurations": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "reward-selection-dialog",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/checkout/shared/reward-selection-dialog/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "checkout-feature-reward-shopping-cart": {
+        "name": "checkout-feature-reward-shopping-cart",
+        "type": "lib",
+        "data": {
+          "root": "libs/checkout/feature/reward-shopping-cart",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/checkout/feature/reward-shopping-cart",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/checkout/feature/reward-shopping-cart/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../../coverage/libs/checkout/feature/reward-shopping-cart"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "checkout-feature-reward-shopping-cart",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/checkout/feature/reward-shopping-cart/src",
+          "prefix": "checkout",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "remi-remission-list": {
+        "name": "remi-remission-list",
+        "type": "lib",
+        "data": {
+          "root": "libs/remission/feature/remission-list",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/remission/feature/remission-list",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/remission/feature/remission-list/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "nx-release-publish": {
+              "executor": "@nx/js:release-publish",
+              "dependsOn": [
+                "^nx-release-publish"
+              ],
+              "options": {},
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/remission/feature/remission-list/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "remi-remission-list",
+          "tags": [
+            "npm:public"
+          ],
+          "metadata": {
+            "targetGroups": {},
+            "js": {
+              "packageName": "@isa/remission/feature/remission-list",
+              "isInPackageManagerWorkspaces": false
+            }
+          },
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/remission/feature/remission-list/src",
+          "prefix": "remi",
+          "projectType": "library",
+          "implicitDependencies": []
+        }
+      },
+      "reward-catalog": {
+        "name": "reward-catalog",
+        "type": "lib",
+        "data": {
+          "root": "libs/checkout/feature/reward-catalog",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/checkout/feature/reward-catalog",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/checkout/feature/reward-catalog/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../../coverage/libs/checkout/feature/reward-catalog"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "reward-catalog",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/checkout/feature/reward-catalog/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "generated-swagger-availability-api": {
+        "name": "generated-swagger-availability-api",
+        "type": "lib",
+        "data": {
+          "root": "generated/swagger/availability-api",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "generated/swagger/availability-api",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/generated/swagger/availability-api/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "generate": {
+              "inputs": [
+                "^production",
+                "{projectRoot}/ng-swagger-gen.json",
+                "!{projectRoot}/src/**/*.ts"
+              ],
+              "outputs": [
+                "{projectRoot}/src"
+              ],
+              "cache": false,
+              "executor": "nx:run-commands",
+              "options": {
+                "command": "ng-swagger-gen --config generated/swagger/availability-api/ng-swagger-gen.json --output generated/swagger/availability-api/src"
+              },
+              "configurations": {},
+              "parallelism": true
+            }
+          },
+          "name": "generated-swagger-availability-api",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "generated/swagger/availability-api/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [
+            "generated",
+            "swagger",
+            "availability",
+            "api"
+          ],
+          "implicitDependencies": []
+        }
+      },
+      "checkout-shared-product-info": {
+        "name": "checkout-shared-product-info",
+        "type": "lib",
+        "data": {
+          "root": "libs/checkout/shared/product-info",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/checkout/shared/product-info",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/checkout/shared/product-info/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../../coverage/libs/checkout/shared/product-info"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "checkout-shared-product-info",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/checkout/shared/product-info/src",
+          "prefix": "checkout",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "generated-swagger-cat-search-api": {
+        "name": "generated-swagger-cat-search-api",
+        "type": "lib",
+        "data": {
+          "root": "generated/swagger/cat-search-api",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "generated/swagger/cat-search-api",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/generated/swagger/cat-search-api/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "generate": {
+              "inputs": [
+                "^production",
+                "{projectRoot}/ng-swagger-gen.json",
+                "!{projectRoot}/src/**/*.ts"
+              ],
+              "outputs": [
+                "{projectRoot}/src"
+              ],
+              "cache": false,
+              "executor": "nx:run-commands",
+              "options": {
+                "command": "ng-swagger-gen --config generated/swagger/cat-search-api/ng-swagger-gen.json --output generated/swagger/cat-search-api/src"
+              },
+              "configurations": {},
+              "parallelism": true
+            }
+          },
+          "name": "generated-swagger-cat-search-api",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "generated/swagger/cat-search-api/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [
+            "generated",
+            "swagger",
+            "cat-search",
+            "api"
+          ],
+          "implicitDependencies": []
+        }
+      },
+      "generated-swagger-inventory-api": {
+        "name": "generated-swagger-inventory-api",
+        "type": "lib",
+        "data": {
+          "root": "generated/swagger/inventory-api",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "generated/swagger/inventory-api",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/generated/swagger/inventory-api/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "generate": {
+              "inputs": [
+                "^production",
+                "{projectRoot}/ng-swagger-gen.json",
+                "!{projectRoot}/src/**/*.ts"
+              ],
+              "outputs": [
+                "{projectRoot}/src"
+              ],
+              "cache": false,
+              "executor": "nx:run-commands",
+              "options": {
+                "command": "ng-swagger-gen --config generated/swagger/inventory-api/ng-swagger-gen.json --output generated/swagger/inventory-api/src"
+              },
+              "configurations": {},
+              "parallelism": true
+            }
+          },
+          "name": "generated-swagger-inventory-api",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "generated/swagger/inventory-api/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [
+            "generated",
+            "swagger",
+            "inventory",
+            "api"
+          ],
+          "implicitDependencies": []
+        }
+      },
+      "oms-feature-return-details": {
+        "name": "oms-feature-return-details",
+        "type": "lib",
+        "data": {
+          "root": "libs/oms/feature/return-details",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/oms/feature/return-details",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/oms/feature/return-details/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/oms/feature/return-details/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "oms-feature-return-details",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/oms/feature/return-details/src",
+          "prefix": "oms-feature",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "oms-feature-return-process": {
+        "name": "oms-feature-return-process",
+        "type": "lib",
+        "data": {
+          "root": "libs/oms/feature/return-process",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/oms/feature/return-process",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/oms/feature/return-process/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/oms/feature/return-process/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "oms-feature-return-process",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/oms/feature/return-process/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "oms-feature-return-summary": {
+        "name": "oms-feature-return-summary",
+        "type": "lib",
+        "data": {
+          "root": "libs/oms/feature/return-summary",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/oms/feature/return-summary",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/oms/feature/return-summary/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/oms/feature/return-summary/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "oms-feature-return-summary",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/oms/feature/return-summary/src",
+          "prefix": "oms-feature",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "shared-product-router-link": {
+        "name": "shared-product-router-link",
+        "type": "lib",
+        "data": {
+          "root": "libs/shared/product-router-link",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/shared/product-router-link",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/shared/product-router-link/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/shared/product-router-link/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "shared-product-router-link",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/shared/product-router-link/src",
+          "prefix": "shared",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "generated-swagger-checkout-api": {
+        "name": "generated-swagger-checkout-api",
+        "type": "lib",
+        "data": {
+          "root": "generated/swagger/checkout-api",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "generated/swagger/checkout-api",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/generated/swagger/checkout-api/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "generate": {
+              "inputs": [
+                "^production",
+                "{projectRoot}/ng-swagger-gen.json",
+                "!{projectRoot}/src/**/*.ts"
+              ],
+              "outputs": [
+                "{projectRoot}/src"
+              ],
+              "cache": false,
+              "executor": "nx:run-commands",
+              "options": {
+                "command": "ng-swagger-gen --config generated/swagger/checkout-api/ng-swagger-gen.json --output generated/swagger/checkout-api/src"
+              },
+              "configurations": {},
+              "parallelism": true
+            }
+          },
+          "name": "generated-swagger-checkout-api",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "generated/swagger/checkout-api/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [
+            "generated",
+            "swagger",
+            "checkout",
+            "api"
+          ],
+          "implicitDependencies": []
+        }
+      },
+      "oms-feature-return-search": {
+        "name": "oms-feature-return-search",
+        "type": "lib",
+        "data": {
+          "root": "libs/oms/feature/return-search",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/oms/feature/return-search",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/oms/feature/return-search/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/oms/feature/return-search/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "oms-feature-return-search",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/oms/feature/return-search/src",
+          "prefix": "oms-feature",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "return-review": {
+        "name": "return-review",
+        "type": "lib",
+        "data": {
+          "root": "libs/oms/feature/return-review",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/oms/feature/return-review",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/oms/feature/return-review/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/oms/feature/return-review/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "return-review",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/oms/feature/return-review/src",
+          "prefix": "oms-feature",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "availability-data-access": {
+        "name": "availability-data-access",
+        "type": "lib",
+        "data": {
+          "root": "libs/availability/data-access",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/availability/data-access",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/availability/data-access/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../coverage/libs/availability/data-access"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "availability-data-access",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/availability/data-access/src",
+          "prefix": "availability",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "remission-shared-product": {
+        "name": "remission-shared-product",
+        "type": "lib",
+        "data": {
+          "root": "libs/remission/shared/product",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/remission/shared/product",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/remission/shared/product/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../../coverage/libs/remission/shared/product"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "remission-shared-product",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/remission/shared/product/src",
+          "prefix": "remi",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "oms-shared-product-info": {
+        "name": "oms-shared-product-info",
+        "type": "lib",
+        "data": {
+          "root": "libs/oms/shared/product-info",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/oms/shared/product-info",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/oms/shared/product-info/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/oms/shared/product-info/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "oms-shared-product-info",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/oms/shared/product-info/src",
+          "prefix": "oms-shared",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "shared-quantity-control": {
+        "name": "shared-quantity-control",
+        "type": "lib",
+        "data": {
+          "root": "libs/shared/quantity-control",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/shared/quantity-control",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/shared/quantity-control/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../coverage/libs/shared/quantity-control"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "shared-quantity-control",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/shared/quantity-control/src",
+          "prefix": "shared",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "generated-swagger-print-api": {
+        "name": "generated-swagger-print-api",
+        "type": "lib",
+        "data": {
+          "root": "generated/swagger/print-api",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "generated/swagger/print-api",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/generated/swagger/print-api/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "generate": {
+              "inputs": [
+                "^production",
+                "{projectRoot}/ng-swagger-gen.json",
+                "!{projectRoot}/src/**/*.ts"
+              ],
+              "outputs": [
+                "{projectRoot}/src"
+              ],
+              "cache": false,
+              "executor": "nx:run-commands",
+              "options": {
+                "command": "ng-swagger-gen --config generated/swagger/print-api/ng-swagger-gen.json --output generated/swagger/print-api/src"
+              },
+              "configurations": {},
+              "parallelism": true
+            }
+          },
+          "name": "generated-swagger-print-api",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "generated/swagger/print-api/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [
+            "generated",
+            "swagger",
+            "print",
+            "api"
+          ],
+          "implicitDependencies": []
+        }
+      },
+      "catalogue-data-access": {
+        "name": "catalogue-data-access",
+        "type": "lib",
+        "data": {
+          "root": "libs/catalogue/data-access",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/catalogue/data-access",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/catalogue/data-access/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/catalogue/data-access/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "catalogue-data-access",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/catalogue/data-access/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "oms-utils-translation": {
+        "name": "oms-utils-translation",
+        "type": "lib",
+        "data": {
+          "root": "libs/oms/utils/translation",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/oms/utils/translation",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/oms/utils/translation/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/oms/utils/translation/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "oms-utils-translation",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/oms/utils/translation/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "remission-data-access": {
+        "name": "remission-data-access",
+        "type": "lib",
+        "data": {
+          "root": "libs/remission/data-access",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/remission/data-access",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/remission/data-access/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "nx-release-publish": {
+              "executor": "@nx/js:release-publish",
+              "dependsOn": [
+                "^nx-release-publish"
+              ],
+              "options": {},
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/remission/data-access/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "remission-data-access",
+          "tags": [
+            "npm:public"
+          ],
+          "metadata": {
+            "targetGroups": {},
+            "js": {
+              "packageName": "@isa/remission/data-access",
+              "isInPackageManagerWorkspaces": false
+            }
+          },
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/remission/data-access/src",
+          "prefix": "remi",
+          "projectType": "library",
+          "implicitDependencies": []
+        }
+      },
+      "shared-product-format": {
+        "name": "shared-product-format",
+        "type": "lib",
+        "data": {
+          "root": "libs/shared/product-format",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/shared/product-format",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/shared/product-format/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/shared/product-format/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "shared-product-format",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/shared/product-format/src",
+          "prefix": "shared",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "utils-scroll-position": {
+        "name": "utils-scroll-position",
+        "type": "lib",
+        "data": {
+          "root": "libs/utils/scroll-position",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/utils/scroll-position",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/utils/scroll-position/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/utils/scroll-position/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "utils-scroll-position",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/utils/scroll-position/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "checkout-data-access": {
+        "name": "checkout-data-access",
+        "type": "lib",
+        "data": {
+          "root": "libs/checkout/data-access",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/checkout/data-access",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/checkout/data-access/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../coverage/libs/checkout/data-access"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "checkout-data-access",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/checkout/data-access/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ean-validation": {
+        "name": "ean-validation",
+        "type": "lib",
+        "data": {
+          "root": "libs/utils/ean-validation",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/utils/ean-validation",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/utils/ean-validation/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../coverage/libs/utils/ean-validation"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ean-validation",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/utils/ean-validation/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "generated-swagger-crm-api": {
+        "name": "generated-swagger-crm-api",
+        "type": "lib",
+        "data": {
+          "root": "generated/swagger/crm-api",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "generated/swagger/crm-api",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/generated/swagger/crm-api/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "generate": {
+              "inputs": [
+                "^production",
+                "{projectRoot}/ng-swagger-gen.json",
+                "!{projectRoot}/src/**/*.ts"
+              ],
+              "outputs": [
+                "{projectRoot}/src"
+              ],
+              "cache": false,
+              "executor": "nx:run-commands",
+              "options": {
+                "command": "ng-swagger-gen --config generated/swagger/crm-api/ng-swagger-gen.json --output generated/swagger/crm-api/src"
+              },
+              "configurations": {},
+              "parallelism": true
+            }
+          },
+          "name": "generated-swagger-crm-api",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "generated/swagger/crm-api/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [
+            "generated",
+            "swagger",
+            "crm",
+            "api"
+          ],
+          "implicitDependencies": []
+        }
+      },
+      "generated-swagger-eis-api": {
+        "name": "generated-swagger-eis-api",
+        "type": "lib",
+        "data": {
+          "root": "generated/swagger/eis-api",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "generated/swagger/eis-api",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/generated/swagger/eis-api/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "download": {
+              "executor": "nx:run-commands",
+              "options": {
+                "command": "curl -o generated/swagger/eis-api/swagger.json https://filialinformationsystem-test.paragon-systems.de/eiswebapi/v1/swagger.json"
+              },
+              "configurations": {},
+              "parallelism": true
+            },
+            "generate": {
+              "inputs": [
+                "^production",
+                "{projectRoot}/swagger.json",
+                "{projectRoot}/ng-swagger-gen.json",
+                "!{projectRoot}/src/**/*.ts"
+              ],
+              "outputs": [
+                "{projectRoot}/src"
+              ],
+              "dependsOn": [
+                "download"
+              ],
+              "cache": false,
+              "executor": "nx:run-commands",
+              "options": {
+                "command": "ng-swagger-gen --config generated/swagger/eis-api/ng-swagger-gen.json --output generated/swagger/eis-api/src --swagger generated/swagger/eis-api/swagger.json"
+              },
+              "configurations": {},
+              "parallelism": true
+            }
+          },
+          "name": "generated-swagger-eis-api",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "generated/swagger/eis-api/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [
+            "generated",
+            "swagger",
+            "eis",
+            "api"
+          ],
+          "implicitDependencies": []
+        }
+      },
+      "generated-swagger-isa-api": {
+        "name": "generated-swagger-isa-api",
+        "type": "lib",
+        "data": {
+          "root": "generated/swagger/isa-api",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "generated/swagger/isa-api",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/generated/swagger/isa-api/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "generate": {
+              "inputs": [
+                "^production",
+                "{projectRoot}/ng-swagger-gen.json",
+                "!{projectRoot}/src/**/*.ts"
+              ],
+              "outputs": [
+                "{projectRoot}/src"
+              ],
+              "cache": false,
+              "executor": "nx:run-commands",
+              "options": {
+                "command": "ng-swagger-gen --config generated/swagger/isa-api/ng-swagger-gen.json --output generated/swagger/isa-api/src"
+              },
+              "configurations": {},
+              "parallelism": true
+            }
+          },
+          "name": "generated-swagger-isa-api",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "generated/swagger/isa-api/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [
+            "generated",
+            "swagger",
+            "isa",
+            "api"
+          ],
+          "implicitDependencies": []
+        }
+      },
+      "generated-swagger-oms-api": {
+        "name": "generated-swagger-oms-api",
+        "type": "lib",
+        "data": {
+          "root": "generated/swagger/oms-api",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "generated/swagger/oms-api",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/generated/swagger/oms-api/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "generate": {
+              "inputs": [
+                "^production",
+                "{projectRoot}/ng-swagger-gen.json",
+                "!{projectRoot}/src/**/*.ts"
+              ],
+              "outputs": [
+                "{projectRoot}/src"
+              ],
+              "cache": false,
+              "executor": "nx:run-commands",
+              "options": {
+                "command": "ng-swagger-gen --config generated/swagger/oms-api/ng-swagger-gen.json --output generated/swagger/oms-api/src"
+              },
+              "configurations": {},
+              "parallelism": true
+            }
+          },
+          "name": "generated-swagger-oms-api",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "generated/swagger/oms-api/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [
+            "generated",
+            "swagger",
+            "oms",
+            "api"
+          ],
+          "implicitDependencies": []
+        }
+      },
+      "generated-swagger-wws-api": {
+        "name": "generated-swagger-wws-api",
+        "type": "lib",
+        "data": {
+          "root": "generated/swagger/wws-api",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "generated/swagger/wws-api",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/generated/swagger/wws-api/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "generate": {
+              "inputs": [
+                "^production",
+                "{projectRoot}/ng-swagger-gen.json",
+                "!{projectRoot}/src/**/*.ts"
+              ],
+              "outputs": [
+                "{projectRoot}/src"
+              ],
+              "cache": false,
+              "executor": "nx:run-commands",
+              "options": {
+                "command": "ng-swagger-gen --config generated/swagger/wws-api/ng-swagger-gen.json --output generated/swagger/wws-api/src"
+              },
+              "configurations": {},
+              "parallelism": true
+            }
+          },
+          "name": "generated-swagger-wws-api",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "generated/swagger/wws-api/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [
+            "generated",
+            "swagger",
+            "wws",
+            "api"
+          ],
+          "implicitDependencies": []
+        }
+      },
+      "return-task-list": {
+        "name": "return-task-list",
+        "type": "lib",
+        "data": {
+          "root": "libs/oms/shared/task-list",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/oms/shared/task-list",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/oms/shared/task-list/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/oms/shared/task-list/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "return-task-list",
+          "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/oms/shared/task-list/src",
+          "prefix": "oms-shared",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "shared-product-image": {
+        "name": "shared-product-image",
+        "type": "lib",
+        "data": {
+          "root": "libs/shared/product-image",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/shared/product-image",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/shared/product-image/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/shared/product-image/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "shared-product-image",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/shared/product-image/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "common-data-access": {
+        "name": "common-data-access",
+        "type": "lib",
+        "data": {
+          "root": "libs/common/data-access",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/common/data-access",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/common/data-access/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/common/data-access/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "common-data-access",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/common/data-access/src",
+          "prefix": "common",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ui-skeleton-loader": {
+        "name": "ui-skeleton-loader",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/skeleton-loader",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/skeleton-loader",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/skeleton-loader/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/ui/skeleton-loader/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ui-skeleton-loader",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/skeleton-loader/src",
+          "prefix": "ui",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "utils-z-safe-parse": {
+        "name": "utils-z-safe-parse",
+        "type": "lib",
+        "data": {
+          "root": "libs/utils/z-safe-parse",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/utils/z-safe-parse",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/utils/z-safe-parse/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/utils/z-safe-parse/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "utils-z-safe-parse",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/utils/z-safe-parse/src",
+          "prefix": "util",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "common-decorators": {
+        "name": "common-decorators",
+        "type": "lib",
+        "data": {
+          "root": "libs/common/decorators",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/common/decorators",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/common/decorators/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../coverage/libs/common/decorators"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "common-decorators",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/common/decorators/src",
+          "prefix": "common",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ui-input-controls": {
+        "name": "ui-input-controls",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/input-controls",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/input-controls",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/input-controls/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/ui/input-controls/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ui-input-controls",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/input-controls/src",
+          "prefix": "ui",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "core-navigation": {
+        "name": "core-navigation",
+        "type": "lib",
+        "data": {
+          "root": "libs/core/navigation",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/core/navigation",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/core/navigation/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../coverage/libs/core/navigation"
+              },
+              "configurations": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "core-navigation",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/core/navigation/src",
+          "prefix": "core",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "crm-data-access": {
+        "name": "crm-data-access",
+        "type": "lib",
+        "data": {
+          "root": "libs/crm/data-access",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/crm/data-access",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/crm/data-access/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../coverage/libs/crm/data-access"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "crm-data-access",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/crm/data-access/src",
+          "prefix": "crm",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "oms-data-access": {
+        "name": "oms-data-access",
+        "type": "lib",
+        "data": {
+          "root": "libs/oms/data-access",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/oms/data-access",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/oms/data-access/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/oms/data-access/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "oms-data-access",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/oms/data-access/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ui-progress-bar": {
+        "name": "ui-progress-bar",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/progress-bar",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/progress-bar",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/progress-bar/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/ui/progress-bar/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ui-progress-bar",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/progress-bar/src",
+          "prefix": "ui",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "shared-address": {
+        "name": "shared-address",
+        "type": "lib",
+        "data": {
+          "root": "libs/shared/address",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/shared/address",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/shared/address/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../coverage/libs/shared/address"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "shared-address",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/shared/address/src",
+          "prefix": "shared",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "shared-scanner": {
+        "name": "shared-scanner",
+        "type": "lib",
+        "data": {
+          "root": "libs/shared/scanner",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/shared/scanner",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/shared/scanner/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/shared/scanner/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "shared-scanner",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/shared/scanner/src",
+          "prefix": "shared",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ui-bullet-list": {
+        "name": "ui-bullet-list",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/bullet-list",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/bullet-list",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/bullet-list/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../coverage/libs/ui/bullet-list"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ui-bullet-list",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/bullet-list/src",
+          "prefix": "ui",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ui-empty-state": {
+        "name": "ui-empty-state",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/empty-state",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/empty-state",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/empty-state/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/ui/empty-state/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ui-empty-state",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/empty-state/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "shared-filter": {
+        "name": "shared-filter",
+        "type": "lib",
+        "data": {
+          "root": "libs/shared/filter",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/shared/filter",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/shared/filter/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/shared/filter/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "shared-filter",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/shared/filter/src",
+          "prefix": "shared",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ui-datepicker": {
+        "name": "ui-datepicker",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/datepicker",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/datepicker",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/datepicker/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/ui/datepicker/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ui-datepicker",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/datepicker/src",
+          "prefix": "ui",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ui-expandable": {
+        "name": "ui-expandable",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/expandable",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/expandable",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/expandable/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/ui/expandable/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ui-expandable",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/expandable/src",
+          "prefix": "ui",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ui-search-bar": {
+        "name": "ui-search-bar",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/search-bar",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/search-bar",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/search-bar/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/ui/search-bar/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ui-search-bar",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/search-bar/src",
+          "prefix": "ui",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "common-print": {
+        "name": "common-print",
+        "type": "lib",
+        "data": {
+          "root": "libs/common/print",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/common/print",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/common/print/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/common/print/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "common-print",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/common/print/src",
+          "prefix": "common-print",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "core-logging": {
+        "name": "core-logging",
+        "type": "lib",
+        "data": {
+          "root": "libs/core/logging",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/core/logging",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/core/logging/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/core/logging/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "core-logging",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/core/logging/src",
+          "prefix": "core",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "core-storage": {
+        "name": "core-storage",
+        "type": "lib",
+        "data": {
+          "root": "libs/core/storage",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/core/storage",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/core/storage/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/core/storage/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "core-storage",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/core/storage/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ui-item-rows": {
+        "name": "ui-item-rows",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/item-rows",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/item-rows",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/item-rows/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/ui/item-rows/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ui-item-rows",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/item-rows/src",
+          "prefix": "ui",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "core-config": {
+        "name": "core-config",
+        "type": "lib",
+        "data": {
+          "root": "libs/core/config",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/core/config",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/core/config/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/core/config/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "core-config",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/core/config/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ui-buttons": {
+        "name": "ui-buttons",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/buttons",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/buttons",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/buttons/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/ui/buttons/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ui-buttons",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/buttons/src",
+          "prefix": "ui",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ui-toolbar": {
+        "name": "ui-toolbar",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/toolbar",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/toolbar",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/toolbar/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/ui/toolbar/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ui-toolbar",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/toolbar/src",
+          "prefix": "ui",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ui-tooltip": {
+        "name": "ui-tooltip",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/tooltip",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/tooltip",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/tooltip/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/ui/tooltip/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ui-tooltip",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/tooltip/src",
+          "prefix": "ui",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "core-tabs": {
+        "name": "core-tabs",
+        "type": "lib",
+        "data": {
+          "root": "libs/core/tabs",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/core/tabs",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/core/tabs/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/core/tabs/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "core-tabs",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/core/tabs/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ui-dialog": {
+        "name": "ui-dialog",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/dialog",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/dialog",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/dialog/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/ui/dialog/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ui-dialog",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/dialog/src",
+          "prefix": "ui-dialog",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ui-layout": {
+        "name": "ui-layout",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/layout",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/layout",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/layout/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/ui/layout/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ui-layout",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/layout/src",
+          "prefix": "ui",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "label": {
+        "name": "label",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/label",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/label",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/label/eslint.config.cjs",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/vite:test",
+              "outputs": [
+                "{options.reportsDirectory}"
+              ],
+              "options": {
+                "reportsDirectory": "../../../coverage/libs/ui/label"
+              },
+              "configurations": {
+                "ci": {
+                  "mode": "run",
+                  "coverage": {
+                    "enabled": true
+                  }
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "label",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/label/src",
+          "prefix": "lib",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "isa-app": {
+        "name": "isa-app",
+        "type": "app",
+        "data": {
+          "root": "apps/isa-app",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "apps/isa-app",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/apps/isa-app/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "build-storybook": {
+              "executor": "@storybook/angular:build-storybook",
+              "outputs": [
+                "{options.outputDir}"
+              ],
+              "options": {
+                "outputDir": "dist/storybook/isa-app",
+                "configDir": "apps/isa-app/.storybook",
+                "browserTarget": "isa-app:build",
+                "compodoc": false,
+                "styles": [
+                  "@angular/cdk/overlay-prebuilt.css",
+                  "apps/isa-app/src/tailwind.scss",
+                  "apps/isa-app/src/styles.scss"
+                ]
+              },
+              "configurations": {
+                "ci": {
+                  "quiet": true
+                }
+              },
+              "parallelism": true,
+              "cache": true
+            },
+            "storybook": {
+              "executor": "@storybook/angular:start-storybook",
+              "options": {
+                "port": 4400,
+                "configDir": "apps/isa-app/.storybook",
+                "browserTarget": "isa-app:build",
+                "compodoc": false,
+                "open": false,
+                "assets": [
+                  {
+                    "glob": "**/*",
+                    "input": "apps/isa-app/src/assets",
+                    "output": "/assets"
+                  }
+                ],
+                "styles": [
+                  "@angular/cdk/overlay-prebuilt.css",
+                  "apps/isa-app/src/tailwind.scss",
+                  "apps/isa-app/src/styles.scss"
+                ]
+              },
+              "configurations": {
+                "ci": {
+                  "quiet": true
+                }
+              },
+              "parallelism": true
+            },
+            "static-storybook": {
+              "dependsOn": [
+                "build-storybook"
+              ],
+              "continuous": true,
+              "executor": "@nx/web:file-server",
+              "options": {
+                "buildTarget": "build-storybook",
+                "staticFilePath": "apps/isa-app/storybook-static"
+              },
+              "configurations": {},
+              "parallelism": true
+            },
+            "build": {
+              "executor": "@angular-devkit/build-angular:application",
+              "options": {
+                "allowedCommonJsDependencies": [
+                  "lodash",
+                  "moment",
+                  "jsrsasign",
+                  "pdfjs-dist/build/pdf",
+                  "pdfjs-dist/web/pdf_viewer",
+                  "pdfjs-dist/es5/build/pdf",
+                  "pdfjs-dist/es5/web/pdf_viewer"
+                ],
+                "outputPath": "dist/isa-app",
+                "index": "apps/isa-app/src/index.html",
+                "browser": "apps/isa-app/src/main.ts",
+                "polyfills": [
+                  "zone.js"
+                ],
+                "tsConfig": "apps/isa-app/tsconfig.app.json",
+                "inlineStyleLanguage": "scss",
+                "assets": [
+                  "apps/isa-app/src/favicon.ico",
+                  "apps/isa-app/src/assets",
+                  "apps/isa-app/src/config",
+                  "apps/isa-app/src/silent-refresh.html",
+                  "apps/isa-app/src/manifest.webmanifest",
+                  {
+                    "glob": "**/*",
+                    "input": "node_modules/scandit-web-datacapture-barcode/build/engine",
+                    "output": "scandit"
+                  }
+                ],
+                "styles": [
+                  "@angular/cdk/overlay-prebuilt.css",
+                  "apps/isa-app/src/tailwind.scss",
+                  "apps/isa-app/src/styles.scss"
+                ],
+                "scripts": []
+              },
+              "configurations": {
+                "production": {
+                  "budgets": [
+                    {
+                      "type": "initial",
+                      "maximumWarning": "2mb",
+                      "maximumError": "5mb"
+                    },
+                    {
+                      "type": "anyComponentStyle",
+                      "maximumWarning": "25kb"
+                    }
+                  ],
+                  "fileReplacements": [
+                    {
+                      "replace": "apps/isa-app/src/environments/environment.ts",
+                      "with": "apps/isa-app/src/environments/environment.prod.ts"
+                    }
+                  ],
+                  "outputHashing": "all",
+                  "serviceWorker": "apps/isa-app/ngsw-config.json"
+                },
+                "development": {
+                  "optimization": false,
+                  "extractLicenses": false,
+                  "sourceMap": true
+                }
+              },
+              "defaultConfiguration": "production",
+              "outputs": [
+                "{options.outputPath}"
+              ],
+              "parallelism": true,
+              "cache": true,
+              "dependsOn": [
+                "^build"
+              ],
+              "inputs": [
+                "production",
+                "^production"
+              ]
+            },
+            "serve": {
+              "executor": "@angular-devkit/build-angular:dev-server",
+              "configurations": {
+                "production": {
+                  "buildTarget": "isa-app:build:production"
+                },
+                "development": {
+                  "buildTarget": "isa-app:build:development"
+                }
+              },
+              "defaultConfiguration": "development",
+              "continuous": true,
+              "options": {},
+              "parallelism": true
+            },
+            "extract-i18n": {
+              "executor": "@angular-devkit/build-angular:extract-i18n",
+              "options": {
+                "buildTarget": "isa-app:build"
+              },
+              "configurations": {},
+              "parallelism": true
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "apps/isa-app/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "serve-static": {
+              "executor": "@nx/web:file-server",
+              "options": {
+                "buildTarget": "isa-app:build",
+                "staticFilePath": "dist/apps/isa-app/browser",
+                "spa": true
+              },
+              "configurations": {},
+              "parallelism": true,
+              "continuous": true
+            }
+          },
+          "name": "isa-app",
+          "$schema": "../../node_modules/nx/schemas/project-schema.json",
+          "projectType": "application",
+          "prefix": "app",
+          "sourceRoot": "apps/isa-app/src",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "ui-menu": {
+        "name": "ui-menu",
+        "type": "lib",
+        "data": {
+          "root": "libs/ui/menu",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/ui/menu",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/ui/menu/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/ui/menu/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            },
+            "lint": {
+              "executor": "@nx/eslint:lint",
+              "configurations": {},
+              "options": {},
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "{workspaceRoot}/.eslintrc.json",
+                "{workspaceRoot}/.eslintignore",
+                "{workspaceRoot}/eslint.config.js"
+              ]
+            }
+          },
+          "name": "ui-menu",
+          "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/ui/menu/src",
+          "prefix": "ui",
+          "projectType": "library",
+          "tags": [],
+          "implicitDependencies": []
+        }
+      },
+      "icons": {
+        "name": "icons",
+        "type": "lib",
+        "data": {
+          "root": "libs/icons",
+          "targets": {
+            "eslint:lint": {
+              "cache": true,
+              "options": {
+                "cwd": "libs/icons",
+                "command": "eslint ."
+              },
+              "inputs": [
+                "default",
+                "^default",
+                "{workspaceRoot}/eslint.config.js",
+                "{workspaceRoot}/libs/icons/eslint.config.js",
+                "{workspaceRoot}/tools/eslint-rules/**/*",
+                {
+                  "externalDependencies": [
+                    "eslint"
+                  ]
+                }
+              ],
+              "outputs": [
+                "{options.outputFile}"
+              ],
+              "metadata": {
+                "technologies": [
+                  "eslint"
+                ],
+                "description": "Runs ESLint on project",
+                "help": {
+                  "command": "npx eslint --help",
+                  "example": {
+                    "options": {
+                      "max-warnings": 0
+                    }
+                  }
+                }
+              },
+              "executor": "nx:run-commands",
+              "configurations": {},
+              "parallelism": true
+            },
+            "test": {
+              "executor": "@nx/jest:jest",
+              "outputs": [
+                "{workspaceRoot}/coverage/{projectRoot}"
+              ],
+              "options": {
+                "jestConfig": "libs/icons/jest.config.ts",
+                "passWithNoTests": true
+              },
+              "configurations": {
+                "ci": {
+                  "ci": true,
+                  "codeCoverage": true
+                }
+              },
+              "parallelism": true,
+              "cache": true,
+              "inputs": [
+                "default",
+                "^production",
+                "{workspaceRoot}/jest.preset.js"
+              ]
+            }
+          },
+          "name": "icons",
+          "tags": [
+            "npm:private"
+          ],
+          "metadata": {
+            "targetGroups": {},
+            "js": {
+              "packageName": "@isa/icons",
+              "packageMain": "./src/index.js",
+              "isInPackageManagerWorkspaces": false
+            }
+          },
+          "$schema": "../../node_modules/nx/schemas/project-schema.json",
+          "sourceRoot": "libs/icons/src",
+          "projectType": "library",
+          "implicitDependencies": []
+        }
+      }
+    },
+    "dependencies": {
+      "remission-feature-remission-return-receipt-details": [
+        {
+          "source": "remission-feature-remission-return-receipt-details",
+          "target": "remission-data-access",
+          "type": "static"
+        },
+        {
+          "source": "remission-feature-remission-return-receipt-details",
+          "target": "ui-skeleton-loader",
+          "type": "static"
+        },
+        {
+          "source": "remission-feature-remission-return-receipt-details",
+          "target": "shared-product-format",
+          "type": "static"
+        },
+        {
+          "source": "remission-feature-remission-return-receipt-details",
+          "target": "shared-product-image",
+          "type": "static"
+        },
+        {
+          "source": "remission-feature-remission-return-receipt-details",
+          "target": "shared-product-router-link",
+          "type": "static"
+        },
+        {
+          "source": "remission-feature-remission-return-receipt-details",
+          "target": "ui-bullet-list",
+          "type": "static"
+        },
+        {
+          "source": "remission-feature-remission-return-receipt-details",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "remission-feature-remission-return-receipt-details",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "remission-feature-remission-return-receipt-details",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "remission-feature-remission-return-receipt-details",
+          "target": "ui-dialog",
+          "type": "static"
+        },
+        {
+          "source": "remission-feature-remission-return-receipt-details",
+          "target": "ui-empty-state",
+          "type": "static"
+        },
+        {
+          "source": "remission-feature-remission-return-receipt-details",
+          "target": "remission-return-receipt-actions",
+          "type": "static"
+        }
+      ],
+      "remission-feature-remission-return-receipt-list": [
+        {
+          "source": "remission-feature-remission-return-receipt-list",
+          "target": "remission-data-access",
+          "type": "static"
+        },
+        {
+          "source": "remission-feature-remission-return-receipt-list",
+          "target": "shared-filter",
+          "type": "static"
+        },
+        {
+          "source": "remission-feature-remission-return-receipt-list",
+          "target": "remission-return-receipt-actions",
+          "type": "static"
+        },
+        {
+          "source": "remission-feature-remission-return-receipt-list",
+          "target": "remission-feature-remission-return-receipt-details",
+          "type": "dynamic"
+        }
+      ],
+      "remission-shared-search-item-to-remit-dialog": [
+        {
+          "source": "remission-shared-search-item-to-remit-dialog",
+          "target": "catalogue-data-access",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-search-item-to-remit-dialog",
+          "target": "common-data-access",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-search-item-to-remit-dialog",
+          "target": "remission-data-access",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-search-item-to-remit-dialog",
+          "target": "ui-input-controls",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-search-item-to-remit-dialog",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-search-item-to-remit-dialog",
+          "target": "ui-dialog",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-search-item-to-remit-dialog",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-search-item-to-remit-dialog",
+          "target": "ui-search-bar",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-search-item-to-remit-dialog",
+          "target": "ui-tooltip",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-search-item-to-remit-dialog",
+          "target": "ui-empty-state",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-search-item-to-remit-dialog",
+          "target": "remission-shared-product",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-search-item-to-remit-dialog",
+          "target": "ui-layout",
+          "type": "static"
+        }
+      ],
+      "checkout-feature-reward-order-confirmation": [],
+      "remission-return-receipt-actions": [
+        {
+          "source": "remission-return-receipt-actions",
+          "target": "remission-data-access",
+          "type": "static"
+        },
+        {
+          "source": "remission-return-receipt-actions",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "remission-return-receipt-actions",
+          "target": "ui-dialog",
+          "type": "static"
+        },
+        {
+          "source": "remission-return-receipt-actions",
+          "target": "ui-dialog",
+          "type": "dynamic"
+        },
+        {
+          "source": "remission-return-receipt-actions",
+          "target": "core-tabs",
+          "type": "static"
+        },
+        {
+          "source": "remission-return-receipt-actions",
+          "target": "core-tabs",
+          "type": "dynamic"
+        },
+        {
+          "source": "remission-return-receipt-actions",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "remission-return-receipt-actions",
+          "target": "remission-start-dialog",
+          "type": "static"
+        }
+      ],
+      "remission-start-dialog": [
+        {
+          "source": "remission-start-dialog",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "remission-start-dialog",
+          "target": "ui-input-controls",
+          "type": "static"
+        },
+        {
+          "source": "remission-start-dialog",
+          "target": "shared-scanner",
+          "type": "static"
+        },
+        {
+          "source": "remission-start-dialog",
+          "target": "remission-data-access",
+          "type": "static"
+        },
+        {
+          "source": "remission-start-dialog",
+          "target": "ui-dialog",
+          "type": "static"
+        },
+        {
+          "source": "remission-start-dialog",
+          "target": "icons",
+          "type": "static"
+        }
+      ],
+      "reward-selection-dialog": [
+        {
+          "source": "reward-selection-dialog",
+          "target": "shared-address",
+          "type": "static"
+        },
+        {
+          "source": "reward-selection-dialog",
+          "target": "checkout-data-access",
+          "type": "static"
+        },
+        {
+          "source": "reward-selection-dialog",
+          "target": "availability-data-access",
+          "type": "static"
+        },
+        {
+          "source": "reward-selection-dialog",
+          "target": "catalogue-data-access",
+          "type": "static"
+        },
+        {
+          "source": "reward-selection-dialog",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "reward-selection-dialog",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "reward-selection-dialog",
+          "target": "core-tabs",
+          "type": "static"
+        },
+        {
+          "source": "reward-selection-dialog",
+          "target": "ui-dialog",
+          "type": "static"
+        },
+        {
+          "source": "reward-selection-dialog",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "reward-selection-dialog",
+          "target": "shared-quantity-control",
+          "type": "static"
+        },
+        {
+          "source": "reward-selection-dialog",
+          "target": "shared-product-image",
+          "type": "static"
+        },
+        {
+          "source": "reward-selection-dialog",
+          "target": "shared-product-router-link",
+          "type": "static"
+        },
+        {
+          "source": "reward-selection-dialog",
+          "target": "crm-data-access",
+          "type": "static"
+        },
+        {
+          "source": "reward-selection-dialog",
+          "target": "ui-skeleton-loader",
+          "type": "static"
+        },
+        {
+          "source": "reward-selection-dialog",
+          "target": "isa-app",
+          "type": "static"
+        }
+      ],
+      "checkout-feature-reward-shopping-cart": [
+        {
+          "source": "checkout-feature-reward-shopping-cart",
+          "target": "crm-data-access",
+          "type": "static"
+        },
+        {
+          "source": "checkout-feature-reward-shopping-cart",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "checkout-feature-reward-shopping-cart",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "checkout-feature-reward-shopping-cart",
+          "target": "shared-address",
+          "type": "static"
+        },
+        {
+          "source": "checkout-feature-reward-shopping-cart",
+          "target": "core-tabs",
+          "type": "static"
+        },
+        {
+          "source": "checkout-feature-reward-shopping-cart",
+          "target": "core-navigation",
+          "type": "static"
+        },
+        {
+          "source": "checkout-feature-reward-shopping-cart",
+          "target": "checkout-data-access",
+          "type": "static"
+        },
+        {
+          "source": "checkout-feature-reward-shopping-cart",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "checkout-feature-reward-shopping-cart",
+          "target": "shared-quantity-control",
+          "type": "static"
+        },
+        {
+          "source": "checkout-feature-reward-shopping-cart",
+          "target": "availability-data-access",
+          "type": "static"
+        },
+        {
+          "source": "checkout-feature-reward-shopping-cart",
+          "target": "ui-layout",
+          "type": "static"
+        },
+        {
+          "source": "checkout-feature-reward-shopping-cart",
+          "target": "checkout-shared-product-info",
+          "type": "static"
+        },
+        {
+          "source": "checkout-feature-reward-shopping-cart",
+          "target": "isa-app",
+          "type": "static"
+        },
+        {
+          "source": "checkout-feature-reward-shopping-cart",
+          "target": "reward-selection-dialog",
+          "type": "static"
+        }
+      ],
+      "remi-remission-list": [
+        {
+          "source": "remi-remission-list",
+          "target": "remission-data-access",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "remission-data-access",
+          "type": "dynamic"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "shared-filter",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "ui-toolbar",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "ui-tooltip",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "ui-skeleton-loader",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "ui-empty-state",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "ui-dialog",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "ui-input-controls",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "remission-shared-product",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "label",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "ui-item-rows",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "ui-layout",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "utils-scroll-position",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "remission-shared-search-item-to-remit-dialog",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "core-tabs",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "remission-start-dialog",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "common-data-access",
+          "type": "static"
+        },
+        {
+          "source": "remi-remission-list",
+          "target": "ean-validation",
+          "type": "static"
+        }
+      ],
+      "reward-catalog": [
+        {
+          "source": "reward-catalog",
+          "target": "catalogue-data-access",
+          "type": "static"
+        },
+        {
+          "source": "reward-catalog",
+          "target": "checkout-data-access",
+          "type": "static"
+        },
+        {
+          "source": "reward-catalog",
+          "target": "shared-filter",
+          "type": "static"
+        },
+        {
+          "source": "reward-catalog",
+          "target": "core-tabs",
+          "type": "static"
+        },
+        {
+          "source": "reward-catalog",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "reward-catalog",
+          "target": "isa-app",
+          "type": "static"
+        },
+        {
+          "source": "reward-catalog",
+          "target": "crm-data-access",
+          "type": "static"
+        },
+        {
+          "source": "reward-catalog",
+          "target": "utils-scroll-position",
+          "type": "static"
+        },
+        {
+          "source": "reward-catalog",
+          "target": "ui-skeleton-loader",
+          "type": "static"
+        },
+        {
+          "source": "reward-catalog",
+          "target": "ui-input-controls",
+          "type": "static"
+        },
+        {
+          "source": "reward-catalog",
+          "target": "ui-item-rows",
+          "type": "static"
+        },
+        {
+          "source": "reward-catalog",
+          "target": "ui-layout",
+          "type": "static"
+        },
+        {
+          "source": "reward-catalog",
+          "target": "checkout-shared-product-info",
+          "type": "static"
+        },
+        {
+          "source": "reward-catalog",
+          "target": "ui-empty-state",
+          "type": "static"
+        }
+      ],
+      "generated-swagger-availability-api": [],
+      "checkout-shared-product-info": [
+        {
+          "source": "checkout-shared-product-info",
+          "target": "checkout-data-access",
+          "type": "static"
+        },
+        {
+          "source": "checkout-shared-product-info",
+          "target": "crm-data-access",
+          "type": "static"
+        },
+        {
+          "source": "checkout-shared-product-info",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "checkout-shared-product-info",
+          "target": "shared-address",
+          "type": "static"
+        },
+        {
+          "source": "checkout-shared-product-info",
+          "target": "catalogue-data-access",
+          "type": "static"
+        },
+        {
+          "source": "checkout-shared-product-info",
+          "target": "shared-product-image",
+          "type": "static"
+        },
+        {
+          "source": "checkout-shared-product-info",
+          "target": "shared-product-router-link",
+          "type": "static"
+        },
+        {
+          "source": "checkout-shared-product-info",
+          "target": "shared-product-format",
+          "type": "static"
+        },
+        {
+          "source": "checkout-shared-product-info",
+          "target": "remission-data-access",
+          "type": "static"
+        },
+        {
+          "source": "checkout-shared-product-info",
+          "target": "ui-skeleton-loader",
+          "type": "static"
+        }
+      ],
+      "generated-swagger-cat-search-api": [],
+      "generated-swagger-inventory-api": [],
+      "oms-feature-return-details": [
+        {
+          "source": "oms-feature-return-details",
+          "target": "oms-data-access",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-details",
+          "target": "oms-utils-translation",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-details",
+          "target": "ui-item-rows",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-details",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-details",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-details",
+          "target": "ui-menu",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-details",
+          "target": "ui-expandable",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-details",
+          "target": "ui-progress-bar",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-details",
+          "target": "shared-product-image",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-details",
+          "target": "ui-input-controls",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-details",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-details",
+          "target": "shared-product-router-link",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-details",
+          "target": "ui-toolbar",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-details",
+          "target": "core-tabs",
+          "type": "static"
+        }
+      ],
+      "oms-feature-return-process": [
+        {
+          "source": "oms-feature-return-process",
+          "target": "oms-data-access",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-process",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-process",
+          "target": "ui-progress-bar",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-process",
+          "target": "oms-shared-product-info",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-process",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-process",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-process",
+          "target": "ui-input-controls",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-process",
+          "target": "catalogue-data-access",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-process",
+          "target": "shared-product-image",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-process",
+          "target": "shared-scanner",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-process",
+          "target": "shared-product-router-link",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-process",
+          "target": "ean-validation",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-process",
+          "target": "core-tabs",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-process",
+          "target": "oms-feature-return-summary",
+          "type": "dynamic"
+        },
+        {
+          "source": "oms-feature-return-process",
+          "target": "return-review",
+          "type": "dynamic"
+        }
+      ],
+      "oms-feature-return-summary": [
+        {
+          "source": "oms-feature-return-summary",
+          "target": "oms-shared-product-info",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-summary",
+          "target": "oms-data-access",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-summary",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-summary",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-summary",
+          "target": "core-tabs",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-summary",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-summary",
+          "target": "return-review",
+          "type": "dynamic"
+        }
+      ],
+      "shared-product-router-link": [],
+      "generated-swagger-checkout-api": [],
+      "oms-feature-return-search": [
+        {
+          "source": "oms-feature-return-search",
+          "target": "generated-swagger-oms-api",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-search",
+          "target": "oms-data-access",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-search",
+          "target": "common-data-access",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-search",
+          "target": "core-tabs",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-search",
+          "target": "return-task-list",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-search",
+          "target": "shared-filter",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-search",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-search",
+          "target": "ui-tooltip",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-search",
+          "target": "ui-item-rows",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-search",
+          "target": "ui-empty-state",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-search",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-search",
+          "target": "ui-layout",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-search",
+          "target": "utils-scroll-position",
+          "type": "static"
+        },
+        {
+          "source": "oms-feature-return-search",
+          "target": "oms-feature-return-details",
+          "type": "dynamic"
+        },
+        {
+          "source": "oms-feature-return-search",
+          "target": "oms-feature-return-process",
+          "type": "dynamic"
+        }
+      ],
+      "return-review": [
+        {
+          "source": "return-review",
+          "target": "core-tabs",
+          "type": "static"
+        },
+        {
+          "source": "return-review",
+          "target": "oms-data-access",
+          "type": "static"
+        },
+        {
+          "source": "return-review",
+          "target": "ui-dialog",
+          "type": "static"
+        },
+        {
+          "source": "return-review",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "return-review",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "return-review",
+          "target": "return-task-list",
+          "type": "static"
+        }
+      ],
+      "availability-data-access": [
+        {
+          "source": "availability-data-access",
+          "target": "generated-swagger-availability-api",
+          "type": "static"
+        },
+        {
+          "source": "availability-data-access",
+          "target": "common-data-access",
+          "type": "static"
+        },
+        {
+          "source": "availability-data-access",
+          "target": "checkout-data-access",
+          "type": "static"
+        },
+        {
+          "source": "availability-data-access",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "availability-data-access",
+          "target": "remission-data-access",
+          "type": "static"
+        },
+        {
+          "source": "availability-data-access",
+          "target": "generated-swagger-oms-api",
+          "type": "static"
+        },
+        {
+          "source": "availability-data-access",
+          "target": "oms-data-access",
+          "type": "static"
+        }
+      ],
+      "remission-shared-product": [
+        {
+          "source": "remission-shared-product",
+          "target": "shared-product-format",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-product",
+          "target": "shared-product-image",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-product",
+          "target": "shared-product-router-link",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-product",
+          "target": "label",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-product",
+          "target": "remission-data-access",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-product",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "remission-shared-product",
+          "target": "ui-skeleton-loader",
+          "type": "static"
+        }
+      ],
+      "oms-shared-product-info": [
+        {
+          "source": "oms-shared-product-info",
+          "target": "shared-product-image",
+          "type": "static"
+        },
+        {
+          "source": "oms-shared-product-info",
+          "target": "oms-data-access",
+          "type": "static"
+        },
+        {
+          "source": "oms-shared-product-info",
+          "target": "shared-product-router-link",
+          "type": "static"
+        },
+        {
+          "source": "oms-shared-product-info",
+          "target": "icons",
+          "type": "static"
+        }
+      ],
+      "shared-quantity-control": [
+        {
+          "source": "shared-quantity-control",
+          "target": "ui-tooltip",
+          "type": "static"
+        },
+        {
+          "source": "shared-quantity-control",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "shared-quantity-control",
+          "target": "icons",
+          "type": "static"
+        }
+      ],
+      "generated-swagger-print-api": [],
+      "catalogue-data-access": [
+        {
+          "source": "catalogue-data-access",
+          "target": "generated-swagger-cat-search-api",
+          "type": "static"
+        },
+        {
+          "source": "catalogue-data-access",
+          "target": "generated-swagger-availability-api",
+          "type": "static"
+        },
+        {
+          "source": "catalogue-data-access",
+          "target": "common-data-access",
+          "type": "static"
+        },
+        {
+          "source": "catalogue-data-access",
+          "target": "core-logging",
+          "type": "static"
+        }
+      ],
+      "oms-utils-translation": [
+        {
+          "source": "oms-utils-translation",
+          "target": "oms-data-access",
+          "type": "static"
+        }
+      ],
+      "remission-data-access": [
+        {
+          "source": "remission-data-access",
+          "target": "catalogue-data-access",
+          "type": "static"
+        },
+        {
+          "source": "remission-data-access",
+          "target": "generated-swagger-inventory-api",
+          "type": "static"
+        },
+        {
+          "source": "remission-data-access",
+          "target": "common-data-access",
+          "type": "static"
+        },
+        {
+          "source": "remission-data-access",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "remission-data-access",
+          "target": "common-decorators",
+          "type": "static"
+        },
+        {
+          "source": "remission-data-access",
+          "target": "core-storage",
+          "type": "static"
+        }
+      ],
+      "shared-product-format": [
+        {
+          "source": "shared-product-format",
+          "target": "icons",
+          "type": "static"
+        }
+      ],
+      "utils-scroll-position": [
+        {
+          "source": "utils-scroll-position",
+          "target": "core-storage",
+          "type": "static"
+        }
+      ],
+      "checkout-data-access": [
+        {
+          "source": "checkout-data-access",
+          "target": "generated-swagger-checkout-api",
+          "type": "static"
+        },
+        {
+          "source": "checkout-data-access",
+          "target": "generated-swagger-checkout-api",
+          "type": "dynamic"
+        },
+        {
+          "source": "checkout-data-access",
+          "target": "availability-data-access",
+          "type": "static"
+        },
+        {
+          "source": "checkout-data-access",
+          "target": "generated-swagger-inventory-api",
+          "type": "static"
+        },
+        {
+          "source": "checkout-data-access",
+          "target": "generated-swagger-crm-api",
+          "type": "static"
+        },
+        {
+          "source": "checkout-data-access",
+          "target": "crm-data-access",
+          "type": "static"
+        },
+        {
+          "source": "checkout-data-access",
+          "target": "generated-swagger-oms-api",
+          "type": "static"
+        },
+        {
+          "source": "checkout-data-access",
+          "target": "common-data-access",
+          "type": "static"
+        },
+        {
+          "source": "checkout-data-access",
+          "target": "catalogue-data-access",
+          "type": "static"
+        },
+        {
+          "source": "checkout-data-access",
+          "target": "core-tabs",
+          "type": "static"
+        },
+        {
+          "source": "checkout-data-access",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "checkout-data-access",
+          "target": "common-decorators",
+          "type": "static"
+        },
+        {
+          "source": "checkout-data-access",
+          "target": "oms-data-access",
+          "type": "static"
+        },
+        {
+          "source": "checkout-data-access",
+          "target": "remission-data-access",
+          "type": "static"
+        },
+        {
+          "source": "checkout-data-access",
+          "target": "core-storage",
+          "type": "static"
+        }
+      ],
+      "ean-validation": [],
+      "generated-swagger-crm-api": [],
+      "generated-swagger-eis-api": [],
+      "generated-swagger-isa-api": [],
+      "generated-swagger-oms-api": [],
+      "generated-swagger-wws-api": [],
+      "return-task-list": [
+        {
+          "source": "return-task-list",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "return-task-list",
+          "target": "oms-data-access",
+          "type": "static"
+        },
+        {
+          "source": "return-task-list",
+          "target": "oms-shared-product-info",
+          "type": "static"
+        },
+        {
+          "source": "return-task-list",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "return-task-list",
+          "target": "core-tabs",
+          "type": "static"
+        },
+        {
+          "source": "return-task-list",
+          "target": "core-logging",
+          "type": "static"
+        }
+      ],
+      "shared-product-image": [
+        {
+          "source": "shared-product-image",
+          "target": "core-config",
+          "type": "static"
+        }
+      ],
+      "common-data-access": [],
+      "ui-skeleton-loader": [],
+      "utils-z-safe-parse": [],
+      "common-decorators": [],
+      "ui-input-controls": [
+        {
+          "source": "ui-input-controls",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "ui-input-controls",
+          "target": "ui-buttons",
+          "type": "static"
+        }
+      ],
+      "core-navigation": [
+        {
+          "source": "core-navigation",
+          "target": "core-tabs",
+          "type": "static"
+        },
+        {
+          "source": "core-navigation",
+          "target": "core-logging",
+          "type": "static"
+        }
+      ],
+      "crm-data-access": [
+        {
+          "source": "crm-data-access",
+          "target": "generated-swagger-crm-api",
+          "type": "static"
+        },
+        {
+          "source": "crm-data-access",
+          "target": "common-data-access",
+          "type": "static"
+        },
+        {
+          "source": "crm-data-access",
+          "target": "core-tabs",
+          "type": "static"
+        },
+        {
+          "source": "crm-data-access",
+          "target": "common-decorators",
+          "type": "static"
+        },
+        {
+          "source": "crm-data-access",
+          "target": "core-logging",
+          "type": "static"
+        }
+      ],
+      "oms-data-access": [
+        {
+          "source": "oms-data-access",
+          "target": "common-data-access",
+          "type": "static"
+        },
+        {
+          "source": "oms-data-access",
+          "target": "generated-swagger-oms-api",
+          "type": "static"
+        },
+        {
+          "source": "oms-data-access",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "oms-data-access",
+          "target": "common-decorators",
+          "type": "static"
+        },
+        {
+          "source": "oms-data-access",
+          "target": "core-tabs",
+          "type": "static"
+        },
+        {
+          "source": "oms-data-access",
+          "target": "common-print",
+          "type": "static"
+        },
+        {
+          "source": "oms-data-access",
+          "target": "generated-swagger-print-api",
+          "type": "static"
+        },
+        {
+          "source": "oms-data-access",
+          "target": "core-storage",
+          "type": "static"
+        },
+        {
+          "source": "oms-data-access",
+          "target": "shared-filter",
+          "type": "static"
+        }
+      ],
+      "ui-progress-bar": [],
+      "shared-address": [
+        {
+          "source": "shared-address",
+          "target": "crm-data-access",
+          "type": "static"
+        }
+      ],
+      "shared-scanner": [
+        {
+          "source": "shared-scanner",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "shared-scanner",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "shared-scanner",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "shared-scanner",
+          "target": "core-config",
+          "type": "static"
+        }
+      ],
+      "ui-bullet-list": [
+        {
+          "source": "ui-bullet-list",
+          "target": "icons",
+          "type": "static"
+        }
+      ],
+      "ui-empty-state": [],
+      "shared-filter": [
+        {
+          "source": "shared-filter",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "shared-filter",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "shared-filter",
+          "target": "ui-layout",
+          "type": "static"
+        },
+        {
+          "source": "shared-filter",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "shared-filter",
+          "target": "ui-input-controls",
+          "type": "static"
+        },
+        {
+          "source": "shared-filter",
+          "target": "ui-datepicker",
+          "type": "static"
+        },
+        {
+          "source": "shared-filter",
+          "target": "ui-search-bar",
+          "type": "static"
+        },
+        {
+          "source": "shared-filter",
+          "target": "shared-scanner",
+          "type": "static"
+        },
+        {
+          "source": "shared-filter",
+          "target": "ui-toolbar",
+          "type": "static"
+        }
+      ],
+      "ui-datepicker": [
+        {
+          "source": "ui-datepicker",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "ui-datepicker",
+          "target": "ui-buttons",
+          "type": "static"
+        }
+      ],
+      "ui-expandable": [],
+      "ui-search-bar": [
+        {
+          "source": "ui-search-bar",
+          "target": "icons",
+          "type": "static"
+        }
+      ],
+      "common-print": [
+        {
+          "source": "common-print",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "common-print",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "common-print",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "common-print",
+          "target": "generated-swagger-print-api",
+          "type": "static"
+        },
+        {
+          "source": "common-print",
+          "target": "ui-dialog",
+          "type": "static"
+        },
+        {
+          "source": "common-print",
+          "target": "ui-input-controls",
+          "type": "static"
+        }
+      ],
+      "core-logging": [],
+      "core-storage": [
+        {
+          "source": "core-storage",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "core-storage",
+          "target": "generated-swagger-isa-api",
+          "type": "static"
+        },
+        {
+          "source": "core-storage",
+          "target": "common-decorators",
+          "type": "static"
+        }
+      ],
+      "ui-item-rows": [],
+      "core-config": [],
+      "ui-buttons": [
+        {
+          "source": "ui-buttons",
+          "target": "icons",
+          "type": "static"
+        }
+      ],
+      "ui-toolbar": [],
+      "ui-tooltip": [
+        {
+          "source": "ui-tooltip",
+          "target": "icons",
+          "type": "static"
+        }
+      ],
+      "core-tabs": [
+        {
+          "source": "core-tabs",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "core-tabs",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "core-tabs",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "core-tabs",
+          "target": "core-storage",
+          "type": "static"
+        }
+      ],
+      "ui-dialog": [
+        {
+          "source": "ui-dialog",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "ui-dialog",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "ui-dialog",
+          "target": "ui-input-controls",
+          "type": "static"
+        }
+      ],
+      "ui-layout": [],
+      "label": [],
+      "isa-app": [
+        {
+          "source": "isa-app",
+          "target": "core-config",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "core-tabs",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "utils-scroll-position",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "reward-catalog",
+          "type": "dynamic"
+        },
+        {
+          "source": "isa-app",
+          "target": "checkout-feature-reward-shopping-cart",
+          "type": "dynamic"
+        },
+        {
+          "source": "isa-app",
+          "target": "checkout-feature-reward-order-confirmation",
+          "type": "dynamic"
+        },
+        {
+          "source": "isa-app",
+          "target": "oms-feature-return-search",
+          "type": "dynamic"
+        },
+        {
+          "source": "isa-app",
+          "target": "remission-feature-remission-return-receipt-list",
+          "type": "dynamic"
+        },
+        {
+          "source": "isa-app",
+          "target": "remi-remission-list",
+          "type": "dynamic"
+        },
+        {
+          "source": "isa-app",
+          "target": "generated-swagger-availability-api",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "generated-swagger-cat-search-api",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "generated-swagger-checkout-api",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "generated-swagger-crm-api",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "generated-swagger-eis-api",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "generated-swagger-isa-api",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "generated-swagger-oms-api",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "generated-swagger-print-api",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "generated-swagger-inventory-api",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "generated-swagger-wws-api",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "core-logging",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "core-storage",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "common-data-access",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "checkout-data-access",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "icons",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "crm-data-access",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "reward-selection-dialog",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "ui-dialog",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "core-navigation",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "checkout-shared-product-info",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "shared-product-image",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "shared-product-router-link",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "remission-data-access",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "remission-shared-product",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "shared-address",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "shared-product-format",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "shared-quantity-control",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "ui-buttons",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "ui-datepicker",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "ui-empty-state",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "ui-expandable",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "ui-input-controls",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "ui-item-rows",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "label",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "ui-progress-bar",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "ui-search-bar",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "ui-skeleton-loader",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "ui-toolbar",
+          "type": "static"
+        },
+        {
+          "source": "isa-app",
+          "target": "ui-tooltip",
+          "type": "static"
+        }
+      ],
+      "ui-menu": [],
+      "icons": []
+    }
+  }
+}
\ No newline at end of file
diff --git a/libs/availability/data-access/README.md b/libs/availability/data-access/README.md
index 024fb8a20..7c61b1702 100644
--- a/libs/availability/data-access/README.md
+++ b/libs/availability/data-access/README.md
@@ -1,7 +1,980 @@
-# availability-data-access
+# @isa/availability/data-access
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive product availability service for Angular applications supporting multiple order types and delivery methods across retail operations.
 
-## Running unit tests
+## Overview
 
-Run `nx test availability-data-access` to execute the unit tests.
+The Availability Data Access library provides a unified interface for checking product availability across six different order types: in-store pickup (Rücklage), customer pickup (Abholung), standard shipping (Versand), digital shipping (DIG-Versand), B2B shipping (B2B-Versand), and digital downloads (Download). It integrates with the generated availability API client and provides intelligent routing, validation, and transformation of availability data.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Order Types](#order-types)
+- [Validation and Business Rules](#validation-and-business-rules)
+- [Error Handling](#error-handling)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Six order type support** - InStore, Pickup, Delivery, DIG-Versand, B2B-Versand, Download
+- **Intelligent routing** - Automatic endpoint selection based on order type
+- **Zod validation** - Runtime schema validation for all parameters
+- **Request cancellation** - AbortSignal support for all operations
+- **Batch and single-item APIs** - Flexible interfaces for different use cases
+- **Preferred availability selection** - Automatic selection of preferred suppliers
+- **Business rule enforcement** - Download validation, B2B logistician override
+- **Type-safe transformations** - Adapter pattern for API request/response mapping
+- **Comprehensive logging** - Integration with @isa/core/logging for debugging
+- **Stock integration** - Direct stock service integration for in-store availability
+
+## Quick Start
+
+### 1. Import and Inject
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { AvailabilityService } from '@isa/availability/data-access';
+
+@Component({
+  selector: 'app-product-detail',
+  template: '...'
+})
+export class ProductDetailComponent {
+  #availabilityService = inject(AvailabilityService);
+}
+```
+
+### 2. Check Availability for Multiple Items
+
+```typescript
+async checkAvailability(): Promise<void> {
+  const availabilities = await this.#availabilityService.getAvailabilities({
+    orderType: 'Versand',
+    items: [
+      { itemId: 123, ean: '1234567890123', quantity: 2 },
+      { itemId: 456, ean: '9876543210987', quantity: 1 }
+    ]
+  });
+
+  // Result: { '123': Availability, '456': Availability }
+  const item123Availability = availabilities['123'];
+  console.log(`Item 123 status: ${item123Availability.status}`);
+  console.log(`Item 123 quantity: ${item123Availability.qty}`);
+}
+```
+
+### 3. Check Availability for Single Item
+
+```typescript
+async checkSingleItem(): Promise<void> {
+  const availability = await this.#availabilityService.getAvailability({
+    orderType: 'Versand',
+    item: { itemId: 123, ean: '1234567890123', quantity: 1 }
+  });
+
+  if (availability) {
+    console.log(`Available: ${availability.qty} units`);
+    console.log(`Price: ${availability.price?.value?.value}`);
+  } else {
+    console.log('Item not available');
+  }
+}
+```
+
+### 4. Request Cancellation
+
+```typescript
+async checkWithCancellation(): Promise<void> {
+  const abortController = new AbortController();
+
+  // Cancel after 5 seconds
+  setTimeout(() => abortController.abort(), 5000);
+
+  try {
+    const availabilities = await this.#availabilityService.getAvailabilities(
+      {
+        orderType: 'Versand',
+        items: [{ itemId: 123, ean: '1234567890123', quantity: 1 }]
+      },
+      abortController.signal
+    );
+  } catch (error) {
+    console.log('Request cancelled or failed');
+  }
+}
+```
+
+## Core Concepts
+
+### Order Types
+
+The library supports six distinct order types, each with specific requirements and behavior:
+
+#### 1. InStore (Rücklage)
+- **Purpose**: Branch-based in-store availability for customer reservation
+- **Endpoint**: Stock service (not availability API)
+- **Required**: branchId, itemsIds array
+- **Special handling**: Uses RemissionStockService to fetch real-time stock quantities
+
+#### 2. Pickup (Abholung)
+- **Purpose**: Customer pickup at branch location
+- **Endpoint**: Store availability API
+- **Required**: branchId, items array with itemId, ean, quantity
+- **Special handling**: Uses store endpoint with branch context
+
+#### 3. Delivery (Versand)
+- **Purpose**: Standard shipping to customer address
+- **Endpoint**: Shipping availability API
+- **Required**: items array with itemId, ean, quantity
+- **Special handling**: Excludes supplier/logistician fields to prevent automatic orderType change
+
+#### 4. DIG-Versand
+- **Purpose**: Digital shipping for webshop customers
+- **Endpoint**: Shipping availability API
+- **Required**: items array with itemId, ean, quantity
+- **Special handling**: Standard transformation, includes supplier/logistician
+
+#### 5. B2B-Versand
+- **Purpose**: Business-to-business shipping with specific logistician
+- **Endpoint**: Store availability API
+- **Required**: items array with itemId, ean, quantity
+- **Special handling**:
+  - Automatically fetches default branch (no branchId parameter needed)
+  - Fetches logistician '2470' and overrides response logisticianId
+  - Uses store endpoint (not shipping)
+
+#### 6. Download
+- **Purpose**: Digital product downloads
+- **Endpoint**: Shipping availability API
+- **Required**: items array with itemId, ean (no quantity)
+- **Special handling**:
+  - Quantity forced to 1
+  - Validates download availability (supplier 16 with 0 stock = unavailable)
+  - Validates status codes against whitelist
+
+### Availability Response Structure
+
+```typescript
+interface Availability {
+  itemId: number;                    // Product item ID
+  status: AvailabilityType;          // Availability status code (see below)
+  qty: number;                       // Available quantity
+  ssc?: string;                      // Shipping service code
+  sscText?: string;                  // Shipping service description
+  supplierId?: number;               // Supplier ID
+  supplier?: string;                 // Supplier name
+  logisticianId?: number;            // Logistician ID
+  logistician?: string;              // Logistician name
+  price?: Price;                     // Current price with VAT
+  priceMaintained?: boolean;         // Price maintenance flag
+  at?: string;                       // Estimated delivery date (ISO format)
+  altAt?: string;                    // Alternative delivery date
+  requestStatusCode?: string;        // Request status from API
+  preferred?: number;                // Preferred availability flag (1 = preferred)
+}
+```
+
+### Availability Type Codes
+
+```typescript
+const AvailabilityType = {
+  NotSet: 0,                  // Not determined
+  NotAvailable: 1,            // Not available
+  PrebookAtBuyer: 2,          // Pre-order at buyer
+  PrebookAtRetailer: 32,      // Pre-order at retailer
+  PrebookAtSupplier: 256,     // Pre-order at supplier
+  TemporaryNotAvailable: 512, // Temporarily unavailable
+  Available: 1024,            // Available for immediate delivery
+  OnDemand: 2048,             // Available on demand
+  AtProductionDate: 4096,     // Available at production date
+  Discontinued: 8192,         // Discontinued product
+  EndOfLife: 16384,           // End of life product
+};
+```
+
+### Validation with Zod
+
+All input parameters are validated using Zod schemas before processing:
+
+```typescript
+// Example: Delivery availability params
+const params = {
+  orderType: 'Versand',
+  items: [
+    {
+      itemId: '123',        // Coerced to number
+      ean: '1234567890123',
+      quantity: '2',        // Coerced to number
+      price: { ... }
+    }
+  ]
+};
+
+// Validation happens automatically
+const result = await service.getAvailabilities(params);
+// Throws ZodError if validation fails
+```
+
+## API Reference
+
+### AvailabilityService
+
+Main service for checking product availability across order types.
+
+#### `getAvailabilities(params, abortSignal?): Promise<{ [itemId: string]: Availability }>`
+
+Checks availability for multiple items based on order type.
+
+**Parameters:**
+- `params: GetAvailabilityInputParams` - Availability parameters (automatically validated)
+- `abortSignal?: AbortSignal` - Optional abort signal for request cancellation
+
+**Returns:** Promise resolving to dictionary mapping itemId to Availability
+
+**Throws:**
+- `ZodError` - If params validation fails
+- `ResponseArgsError` - If API returns an error
+- `Error` - If default branch/logistician not found (B2B only)
+
+**Example:**
+```typescript
+const availabilities = await service.getAvailabilities({
+  orderType: 'Versand',
+  items: [
+    { itemId: 123, ean: '1234567890', quantity: 2 },
+    { itemId: 456, ean: '0987654321', quantity: 1 }
+  ]
+});
+
+// Result: { '123': Availability, '456': Availability }
+```
+
+#### `getAvailability(params, abortSignal?): Promise<Availability | undefined>`
+
+Checks availability for a single item.
+
+**Parameters:**
+- `params: GetSingleItemAvailabilityInputParams` - Single item parameters (automatically validated)
+- `abortSignal?: AbortSignal` - Optional abort signal for request cancellation
+
+**Returns:** Promise resolving to Availability, or undefined if not available
+
+**Throws:**
+- `ZodError` - If params validation fails
+- `ResponseArgsError` - If API returns an error
+
+**Example:**
+```typescript
+const availability = await service.getAvailability({
+  orderType: 'Versand',
+  item: { itemId: 123, ean: '1234567890', quantity: 1 }
+});
+
+if (availability) {
+  console.log(`Available: ${availability.qty} units`);
+}
+```
+
+### AvailabilityFacade
+
+Pass-through facade for AvailabilityService.
+
+**Note**: This facade is currently under architectural review. It provides no additional value over direct service injection and may be removed in a future refactoring. Consider injecting `AvailabilityService` directly.
+
+```typescript
+// Current pattern (via facade)
+#availabilityFacade = inject(AvailabilityFacade);
+
+// Recommended pattern (direct service)
+#availabilityService = inject(AvailabilityService);
+```
+
+### Helper Functions
+
+#### `isDownloadAvailable(availability): boolean`
+
+Validates if a download item is available based on business rules.
+
+**Business Rules:**
+- Supplier ID 16 with 0 stock = unavailable
+- Must have valid availability type code (see VALID_DOWNLOAD_STATUS_CODES)
+
+**Parameters:**
+- `availability: Availability | null | undefined` - Availability to validate
+
+**Returns:** true if download is available, false otherwise
+
+**Example:**
+```typescript
+import { isDownloadAvailable } from '@isa/availability/data-access';
+
+if (isDownloadAvailable(availability)) {
+  console.log('Download ready');
+}
+```
+
+#### `selectPreferredAvailability(availabilities): Availability | undefined`
+
+Selects the preferred availability from a list (marked with `preferred === 1`).
+
+**Parameters:**
+- `availabilities: Availability[]` - List of availability options
+
+**Returns:** The preferred availability, or undefined if none found
+
+**Example:**
+```typescript
+import { selectPreferredAvailability } from '@isa/availability/data-access';
+
+const preferred = selectPreferredAvailability(apiResponse);
+```
+
+#### `calculateEstimatedDate(availability): string | undefined`
+
+Calculates the estimated shipping/delivery date based on API response.
+
+**Business Rule:**
+- If requestStatusCode === '32', use altAt (alternative date)
+- Otherwise, use at (standard date)
+
+**Parameters:**
+- `availability: Availability | null | undefined` - Availability data
+
+**Returns:** The estimated date string (ISO format), or undefined
+
+**Example:**
+```typescript
+import { calculateEstimatedDate } from '@isa/availability/data-access';
+
+const estimatedDate = calculateEstimatedDate(availability);
+console.log(`Delivery expected: ${estimatedDate}`);
+```
+
+#### `hasValidPrice(availability): boolean`
+
+Type guard to check if an availability has a valid price.
+
+**Parameters:**
+- `availability: Availability | null | undefined` - Availability to check
+
+**Returns:** true if availability has a price with a value > 0
+
+**Example:**
+```typescript
+import { hasValidPrice } from '@isa/availability/data-access';
+
+if (hasValidPrice(availability)) {
+  // TypeScript narrows type - price is guaranteed to exist
+  console.log(`Price: ${availability.price.value.value}`);
+}
+```
+
+#### `isPriceMaintained(availability): boolean`
+
+Checks if an availability is price-maintained.
+
+**Parameters:**
+- `availability: Availability | null | undefined` - Availability to check
+
+**Returns:** true if price-maintained flag is set
+
+## Usage Examples
+
+### Checking In-Store Availability (Rücklage)
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { AvailabilityService } from '@isa/availability/data-access';
+
+@Component({
+  selector: 'app-in-store-check',
+  template: '...'
+})
+export class InStoreCheckComponent {
+  #availabilityService = inject(AvailabilityService);
+
+  async checkInStoreAvailability(branchId: number, itemIds: number[]): Promise<void> {
+    const availabilities = await this.#availabilityService.getAvailabilities({
+      orderType: 'Rücklage',
+      branchId: branchId,
+      itemsIds: itemIds
+    });
+
+    for (const [itemId, availability] of Object.entries(availabilities)) {
+      console.log(`Item ${itemId}: ${availability.qty} in stock`);
+    }
+  }
+}
+```
+
+### Checking Pickup Availability (Abholung)
+
+```typescript
+async checkPickupAvailability(branchId: number): Promise<void> {
+  const availabilities = await this.#availabilityService.getAvailabilities({
+    orderType: 'Abholung',
+    branchId: branchId,
+    items: [
+      { itemId: 123, ean: '1234567890', quantity: 2 },
+      { itemId: 456, ean: '0987654321', quantity: 1 }
+    ]
+  });
+
+  // Check if items are available for pickup
+  for (const [itemId, availability] of Object.entries(availabilities)) {
+    if (availability.status === AvailabilityType.Available) {
+      console.log(`Item ${itemId} ready for pickup at branch ${branchId}`);
+    }
+  }
+}
+```
+
+### Checking Standard Delivery (Versand)
+
+```typescript
+import { AvailabilityType, calculateEstimatedDate } from '@isa/availability/data-access';
+
+async checkDeliveryAvailability(): Promise<void> {
+  const availabilities = await this.#availabilityService.getAvailabilities({
+    orderType: 'Versand',
+    items: [
+      {
+        itemId: 123,
+        ean: '1234567890',
+        quantity: 1,
+        price: {
+          value: { value: 19.99, currency: 'EUR', currencySymbol: '€' },
+          vat: { value: 3.18, inPercent: 19, label: '19%', vatType: 1 }
+        }
+      }
+    ]
+  });
+
+  const item123 = availabilities['123'];
+  if (item123) {
+    const estimatedDate = calculateEstimatedDate(item123);
+    console.log(`Available for delivery: ${item123.qty} units`);
+    console.log(`Estimated delivery: ${estimatedDate}`);
+    console.log(`Supplier: ${item123.supplier} (ID: ${item123.supplierId})`);
+  }
+}
+```
+
+### Checking B2B Delivery (B2B-Versand)
+
+```typescript
+async checkB2BDelivery(): Promise<void> {
+  // No branchId required - automatically uses default branch
+  // Logistician '2470' is automatically fetched and applied
+  const availabilities = await this.#availabilityService.getAvailabilities({
+    orderType: 'B2B-Versand',
+    items: [
+      { itemId: 123, ean: '1234567890', quantity: 10 }
+    ]
+  });
+
+  const item123 = availabilities['123'];
+  if (item123) {
+    console.log(`B2B availability: ${item123.qty} units`);
+    console.log(`Logistician: ${item123.logisticianId} (overridden to 2470)`);
+  }
+}
+```
+
+### Checking Download Availability
+
+```typescript
+import { isDownloadAvailable } from '@isa/availability/data-access';
+
+async checkDownloadAvailability(): Promise<void> {
+  const availabilities = await this.#availabilityService.getAvailabilities({
+    orderType: 'Download',
+    items: [
+      { itemId: 123, ean: '1234567890' }  // No quantity needed
+    ]
+  });
+
+  const item123 = availabilities['123'];
+  if (item123 && isDownloadAvailable(item123)) {
+    console.log('Download ready for immediate delivery');
+  } else {
+    console.log('Download not available');
+  }
+}
+```
+
+### Single Item with AbortSignal
+
+```typescript
+async checkSingleItemWithTimeout(): Promise<void> {
+  const abortController = new AbortController();
+
+  // Set 10 second timeout
+  const timeoutId = setTimeout(() => {
+    abortController.abort();
+  }, 10000);
+
+  try {
+    const availability = await this.#availabilityService.getAvailability(
+      {
+        orderType: 'Versand',
+        item: { itemId: 123, ean: '1234567890', quantity: 1 }
+      },
+      abortController.signal
+    );
+
+    clearTimeout(timeoutId);
+
+    if (availability) {
+      console.log(`Item available: ${availability.qty} units`);
+    }
+  } catch (error) {
+    clearTimeout(timeoutId);
+    console.error('Request failed or timed out', error);
+  }
+}
+```
+
+### Handling Multiple Order Types
+
+```typescript
+import { OrderType } from '@isa/checkout/data-access';
+
+async checkMultipleOrderTypes(
+  orderType: OrderType,
+  items: Array<{ itemId: number; ean: string; quantity: number }>
+): Promise<void> {
+  let params: GetAvailabilityInputParams;
+
+  switch (orderType) {
+    case 'Rücklage':
+      params = {
+        orderType: 'Rücklage',
+        branchId: this.selectedBranchId,
+        itemsIds: items.map(i => i.itemId)
+      };
+      break;
+    case 'Abholung':
+      params = {
+        orderType: 'Abholung',
+        branchId: this.selectedBranchId,
+        items: items
+      };
+      break;
+    case 'Versand':
+    case 'DIG-Versand':
+      params = {
+        orderType: orderType,
+        items: items
+      };
+      break;
+    case 'B2B-Versand':
+      params = {
+        orderType: 'B2B-Versand',
+        items: items
+      };
+      break;
+    case 'Download':
+      params = {
+        orderType: 'Download',
+        items: items.map(i => ({ itemId: i.itemId, ean: i.ean }))
+      };
+      break;
+  }
+
+  const availabilities = await this.#availabilityService.getAvailabilities(params);
+
+  console.log(`${orderType} availability:`, availabilities);
+}
+```
+
+## Order Types
+
+### Parameter Requirements by Order Type
+
+| Order Type | Required Parameters | Optional | Notes |
+|------------|-------------------|----------|-------|
+| **Rücklage** (InStore) | `orderType`, `itemsIds` | `branchId` | Uses stock service |
+| **Abholung** (Pickup) | `orderType`, `branchId`, `items` | - | Store endpoint |
+| **Versand** (Delivery) | `orderType`, `items` | - | Shipping endpoint, excludes supplier/logistician |
+| **DIG-Versand** | `orderType`, `items` | - | Shipping endpoint |
+| **B2B-Versand** | `orderType`, `items` | - | Fetches default branch + logistician 2470 |
+| **Download** | `orderType`, `items` (no quantity) | - | Quantity forced to 1, validation applied |
+
+### Item Structure by Order Type
+
+#### InStore (Rücklage)
+```typescript
+{
+  orderType: 'Rücklage',
+  branchId?: number,           // Optional branch ID
+  itemsIds: number[]           // Array of item IDs only
+}
+```
+
+#### Pickup, Delivery, DIG-Versand, B2B-Versand
+```typescript
+{
+  orderType: 'Abholung' | 'Versand' | 'DIG-Versand' | 'B2B-Versand',
+  branchId?: number,           // Required only for Abholung
+  items: Array<{
+    itemId: number,
+    ean: string,
+    quantity: number,
+    price?: Price              // Optional price information
+  }>
+}
+```
+
+#### Download
+```typescript
+{
+  orderType: 'Download',
+  items: Array<{
+    itemId: number,
+    ean: string,
+    price?: Price              // Optional price information
+    // No quantity field - always 1
+  }>
+}
+```
+
+## Validation and Business Rules
+
+### Zod Schema Validation
+
+All parameters are validated using Zod schemas before processing:
+
+**Type Coercion:**
+```typescript
+// String to number coercion
+{ itemId: '123' }  →  { itemId: 123 }
+{ quantity: '2' }  →  { quantity: 2 }
+
+// Validation requirements
+itemId: z.coerce.number().int().positive()  // Must be positive integer
+quantity: z.coerce.number().int().positive().default(1)  // Positive with default
+ean: z.string()  // Required string
+```
+
+**Minimum Array Lengths:**
+```typescript
+items: z.array(ItemSchema).min(1)  // At least 1 item required
+itemsIds: z.array(z.coerce.number()).min(1)  // At least 1 ID required
+```
+
+### Download Validation Rules
+
+Downloads have special validation requirements enforced by `isDownloadAvailable()`:
+
+1. **Supplier 16 with 0 stock = unavailable**
+   ```typescript
+   if (availability.supplierId === 16 && availability.qty === 0) {
+     return false;  // Not available
+   }
+   ```
+
+2. **Valid status codes for downloads**
+   ```typescript
+   const VALID_CODES = [
+     AvailabilityType.PrebookAtBuyer,       // 2
+     AvailabilityType.PrebookAtRetailer,    // 32
+     AvailabilityType.PrebookAtSupplier,    // 256
+     AvailabilityType.Available,            // 1024
+     AvailabilityType.OnDemand,             // 2048
+     AvailabilityType.AtProductionDate      // 4096
+   ];
+   ```
+
+### B2B Special Handling
+
+B2B-Versand has unique requirements:
+
+1. **Automatic default branch fetching**
+   - No branchId parameter required
+   - Service automatically fetches default branch via `BranchService`
+   - Throws error if default branch has no ID
+
+2. **Logistician 2470 override**
+   - Automatically fetches logistician '2470'
+   - Overrides all availability responses with this logisticianId
+   - Throws error if logistician 2470 not found
+
+3. **Store endpoint usage**
+   - Uses store availability endpoint (not shipping)
+   - Similar to Pickup but with automatic branch selection
+
+### Preferred Availability Selection
+
+When multiple availability options exist for an item:
+
+```typescript
+// API might return multiple availabilities per item
+// The service automatically selects the preferred one
+const preferred = availabilities.find(av => av.preferred === 1);
+```
+
+Only the preferred availability is included in the result dictionary.
+
+## Error Handling
+
+### Error Types
+
+#### ZodError
+Thrown when input parameters fail validation:
+
+```typescript
+try {
+  await service.getAvailabilities({
+    orderType: 'Versand',
+    items: []  // Empty array - fails min(1) validation
+  });
+} catch (error) {
+  if (error instanceof ZodError) {
+    console.error('Validation error:', error.errors);
+    // error.errors contains detailed validation failures
+  }
+}
+```
+
+#### ResponseArgsError
+Thrown when the API returns an error:
+
+```typescript
+import { ResponseArgsError } from '@isa/common/data-access';
+
+try {
+  await service.getAvailabilities(params);
+} catch (error) {
+  if (error instanceof ResponseArgsError) {
+    console.error('API error:', error.message);
+    // Check error.message for details
+  }
+}
+```
+
+#### Error (Generic)
+Thrown for business logic failures:
+
+```typescript
+try {
+  // B2B-Versand without default branch
+  await service.getAvailabilities({
+    orderType: 'B2B-Versand',
+    items: [{ itemId: 123, ean: '123', quantity: 1 }]
+  });
+} catch (error) {
+  if (error.message === 'Default branch has no ID') {
+    console.error('Branch configuration error');
+  }
+  if (error.message === 'Logistician 2470 not found') {
+    console.error('Logistician configuration error');
+  }
+}
+```
+
+### Error Context Logging
+
+The service automatically logs errors with context:
+
+```typescript
+// Logged automatically on error
+{
+  orderType: 'Versand',
+  itemIds: [123, 456],
+  additional: { /* context-specific data */ }
+}
+```
+
+### Request Cancellation
+
+Use AbortSignal to cancel in-flight requests:
+
+```typescript
+const controller = new AbortController();
+
+// Start request
+const promise = service.getAvailabilities(params, controller.signal);
+
+// Cancel if needed
+controller.abort();
+
+try {
+  await promise;
+} catch (error) {
+  // Handle cancellation or other errors
+  console.log('Request cancelled or failed');
+}
+```
+
+## Testing
+
+The library uses **Vitest** with **Angular Testing Utilities** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test availability-data-access --skip-nx-cache
+
+# Run tests with coverage
+npx nx test availability-data-access --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test availability-data-access --watch
+```
+
+### Test Structure
+
+The library includes comprehensive unit tests covering:
+
+- **Order type routing** - Validates correct endpoint selection for each order type
+- **Validation** - Tests Zod schema validation for all parameter types
+- **Business rules** - Tests download validation, B2B logistician override, etc.
+- **Error handling** - Tests API errors, validation failures, missing data
+- **Abort signal support** - Tests request cancellation
+- **Multiple items** - Tests batch processing
+- **Preferred selection** - Tests preferred availability selection logic
+
+### Example Test
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { AvailabilityService } from './availability.service';
+
+describe('AvailabilityService', () => {
+  let service: AvailabilityService;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      providers: [
+        AvailabilityService,
+        // Mock providers...
+      ]
+    });
+    service = TestBed.inject(AvailabilityService);
+  });
+
+  it('should fetch standard delivery availability', async () => {
+    const result = await service.getAvailabilities({
+      orderType: 'Versand',
+      items: [{ itemId: 123, ean: '1234567890', quantity: 3 }]
+    });
+
+    expect(result).toHaveProperty('123');
+    expect(result['123'].itemId).toBe(123);
+  });
+});
+```
+
+## Architecture Notes
+
+### Current Architecture
+
+The library follows a layered architecture:
+
+```
+Components/Features
+       ↓
+  AvailabilityFacade (optional, pass-through)
+       ↓
+  AvailabilityService (main business logic)
+       ↓
+├─→ RemissionStockService (InStore)
+├─→ AvailabilityRequestAdapter (request mapping)
+├─→ Generated API Client (availability-api)
+└─→ Helper functions (transformers, validators)
+```
+
+### Known Architectural Considerations
+
+#### 1. Facade Evaluation (Medium Priority)
+
+The `AvailabilityFacade` is currently under evaluation:
+
+**Current State:**
+- Pass-through wrapper with no added value
+- Just delegates to AvailabilityService
+- No orchestration logic
+
+**Recommendation:**
+- Consider removal if no orchestration is planned
+- Update components to inject AvailabilityService directly
+- Keep facade only if future orchestration is planned
+
+**Impact:** Low risk, reduces one layer of indirection
+
+#### 2. Order Type Handler Duplication (High Priority)
+
+The service contains 6 similar handler methods with significant code duplication:
+
+**Current State:**
+- ~180 lines of duplicated code
+- Bug fixes need to be applied to multiple methods
+
+**Proposed Refactoring:**
+- Template Method + Strategy pattern
+- Handler registry with common workflow
+- Post-processing hooks for special cases
+
+**Impact:** High value, reduces complexity significantly
+
+#### 3. Cross-Domain Dependency
+
+The library depends on `@isa/remission/data-access` for `BranchService`:
+
+**Current State:**
+- Direct dependency on remission domain
+- Availability domain cannot be used without remission domain
+
+**Proposed Solution:**
+- Create abstract `DefaultBranchProvider` interface
+- Inject provider instead of concrete BranchService
+- Implement at app level for domain independence
+
+**Impact:** Improves domain boundaries and testability
+
+### Performance Considerations
+
+1. **Parallel Requests** - B2B-Versand fetches branch and logistician in parallel
+2. **Early Validation** - Zod validation fails fast before API calls
+3. **Preferred Selection** - Efficient filtering with Array.find()
+4. **Request Cancellation** - AbortSignal support prevents wasted bandwidth
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Caching Layer** - Cache availability responses for short periods
+2. **Batch Optimization** - Optimize multiple availability checks
+3. **Retry Logic** - Automatic retry for transient failures
+4. **Analytics Integration** - Track availability check patterns
+5. **Schema Simplification** - Reduce single-item schema duplication
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework
+- `@generated/swagger/availability-api` - Generated API client
+- `@isa/common/data-access` - Common data access utilities
+- `@isa/core/logging` - Logging service
+- `@isa/checkout/data-access` - Supplier and OrderType
+- `@isa/remission/data-access` - Stock and branch services
+- `@isa/oms/data-access` - Logistician service
+- `zod` - Schema validation
+- `rxjs` - Reactive programming
+
+### Path Alias
+
+Import from: `@isa/availability/data-access`
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/availability/data-access/src/lib/schemas/get-availability-params.schema.ts b/libs/availability/data-access/src/lib/schemas/get-availability-params.schema.ts
index 14fe699f6..b97ec39a3 100644
--- a/libs/availability/data-access/src/lib/schemas/get-availability-params.schema.ts
+++ b/libs/availability/data-access/src/lib/schemas/get-availability-params.schema.ts
@@ -32,57 +32,57 @@ import { PriceSchema } from '@isa/common/data-access';
 
 // Base item schema - used for all availability checks
 const ItemSchema = z.object({
-  itemId: z.coerce.number().int().positive(),
-  ean: z.string(),
-  price: PriceSchema.optional(),
-  quantity: z.coerce.number().int().positive().default(1),
+  itemId: z.coerce.number().int().positive().describe('Unique item identifier'),
+  ean: z.string().describe('European Article Number barcode'),
+  price: PriceSchema.describe('Item price information').optional(),
+  quantity: z.coerce.number().int().positive().default(1).describe('Quantity of items to check availability for'),
 });
 
 // Download items don't require quantity (always 1)
 const DownloadItemSchema = z.object({
-  itemId: z.coerce.number().int().positive(),
-  ean: z.string(),
-  price: PriceSchema.optional(),
+  itemId: z.coerce.number().int().positive().describe('Unique item identifier'),
+  ean: z.string().describe('European Article Number barcode'),
+  price: PriceSchema.describe('Item price information').optional(),
 });
 
-const ItemsSchema = z.array(ItemSchema).min(1);
-const DownloadItemsSchema = z.array(DownloadItemSchema).min(1);
+const ItemsSchema = z.array(ItemSchema).min(1).describe('List of items to check availability for');
+const DownloadItemsSchema = z.array(DownloadItemSchema).min(1).describe('List of download items to check availability for');
 
 // In-Store availability (Rücklage) - requires branch context
 export const GetInStoreAvailabilityParamsSchema = z.object({
-  orderType: z.literal(OrderType.InStore),
-  branchId: z.coerce.number().int().positive().optional(),
-  itemsIds: z.array(z.coerce.number().int().positive()).min(1),
+  orderType: z.literal(OrderType.InStore).describe('Order type specifying in-store availability check'),
+  branchId: z.coerce.number().int().positive().describe('Branch identifier for in-store availability').optional(),
+  itemsIds: z.array(z.coerce.number().int().positive()).min(1).describe('List of item identifiers to check in-store availability'),
 });
 
 // Pickup availability (Abholung) - requires branch context
 export const GetPickupAvailabilityParamsSchema = z.object({
-  orderType: z.literal(OrderType.Pickup),
-  branchId: z.coerce.number().int().positive(),
+  orderType: z.literal(OrderType.Pickup).describe('Order type specifying pickup availability check'),
+  branchId: z.coerce.number().int().positive().describe('Branch identifier where items will be picked up'),
   items: ItemsSchema,
 });
 
 // Standard delivery availability (Versand)
 export const GetDeliveryAvailabilityParamsSchema = z.object({
-  orderType: z.literal(OrderType.Delivery),
+  orderType: z.literal(OrderType.Delivery).describe('Order type specifying standard delivery availability check'),
   items: ItemsSchema,
 });
 
 // DIG delivery availability (DIG-Versand) - for webshop customers
 export const GetDigDeliveryAvailabilityParamsSchema = z.object({
-  orderType: z.literal(OrderType.DigitalShipping),
+  orderType: z.literal(OrderType.DigitalShipping).describe('Order type specifying DIG delivery availability check for webshop customers'),
   items: ItemsSchema,
 });
 
 // B2B delivery availability (B2B-Versand) - uses default branch
 export const GetB2bDeliveryAvailabilityParamsSchema = z.object({
-  orderType: z.literal(OrderType.B2BShipping),
+  orderType: z.literal(OrderType.B2BShipping).describe('Order type specifying B2B delivery availability check'),
   items: ItemsSchema,
 });
 
 // Download availability - quantity always 1
 export const GetDownloadAvailabilityParamsSchema = z.object({
-  orderType: z.literal(OrderType.Download),
+  orderType: z.literal(OrderType.Download).describe('Order type specifying download availability check'),
   items: DownloadItemsSchema,
 });
 
@@ -125,34 +125,34 @@ export type GetDownloadAvailabilityParams = z.infer<
 
 // Single-item schemas use the same structure but accept a single item instead of an array
 const SingleInStoreAvailabilityParamsSchema = z.object({
-  orderType: z.literal(OrderType.InStore),
-  branchId: z.coerce.number().int().positive(),
-  itemId: z.number().int().positive(),
+  orderType: z.literal(OrderType.InStore).describe('Order type specifying in-store availability check'),
+  branchId: z.coerce.number().int().positive().describe('Branch identifier for in-store availability').optional(),
+  itemId: z.number().int().positive().describe('Unique item identifier to check in-store availability'),
 });
 
 const SinglePickupAvailabilityParamsSchema = z.object({
-  orderType: z.literal(OrderType.Pickup),
-  branchId: z.coerce.number().int().positive(),
+  orderType: z.literal(OrderType.Pickup).describe('Order type specifying pickup availability check'),
+  branchId: z.coerce.number().int().positive().describe('Branch identifier where item will be picked up'),
   item: ItemSchema,
 });
 
 const SingleDeliveryAvailabilityParamsSchema = z.object({
-  orderType: z.literal(OrderType.Delivery),
+  orderType: z.literal(OrderType.Delivery).describe('Order type specifying standard delivery availability check'),
   item: ItemSchema,
 });
 
 const SingleDigDeliveryAvailabilityParamsSchema = z.object({
-  orderType: z.literal(OrderType.DigitalShipping),
+  orderType: z.literal(OrderType.DigitalShipping).describe('Order type specifying DIG delivery availability check for webshop customers'),
   item: ItemSchema,
 });
 
 const SingleB2bDeliveryAvailabilityParamsSchema = z.object({
-  orderType: z.literal(OrderType.B2BShipping),
+  orderType: z.literal(OrderType.B2BShipping).describe('Order type specifying B2B delivery availability check'),
   item: ItemSchema,
 });
 
 const SingleDownloadAvailabilityParamsSchema = z.object({
-  orderType: z.literal(OrderType.Download),
+  orderType: z.literal(OrderType.Download).describe('Order type specifying download availability check'),
   item: DownloadItemSchema,
 });
 
diff --git a/libs/catalogue/data-access/README.md b/libs/catalogue/data-access/README.md
index 0c93c16ea..c4fab7840 100644
--- a/libs/catalogue/data-access/README.md
+++ b/libs/catalogue/data-access/README.md
@@ -1,7 +1,1482 @@
-# catalogue-data-access
+# @isa/catalogue/data-access
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive product catalogue search and availability service for Angular applications, providing catalog item search, loyalty program integration, and specialized availability validation for download and delivery order types.
 
-## Running unit tests
+## Overview
 
-Run `nx test catalogue-data-access` to execute the unit tests.
+The Catalogue Data Access library provides a unified interface for searching and retrieving product catalog data, managing loyalty reward items, and validating product availability for digital downloads, DIG shipping, and B2B delivery. It integrates with the generated cat-search-api and availability-api clients to provide intelligent search routing, validation, and transformation of catalog and availability data.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Search Types](#search-types)
+- [Availability Validation](#availability-validation)
+- [Validation and Business Rules](#validation-and-business-rules)
+- [Error Handling](#error-handling)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Multi-type search support** - EAN, term-based, and loyalty item search
+- **Loyalty program integration** - Specialized filtering and settings for reward items
+- **Availability validation** - Download, DIG delivery, and B2B delivery validation
+- **Zod validation** - Runtime schema validation for all parameters
+- **Request cancellation** - AbortSignal support for all operations
+- **Pagination support** - Skip/take parameters for search results
+- **Filtering and sorting** - Advanced query token system with filters and orderBy
+- **Type-safe transformations** - Extends generated DTOs with domain types
+- **Comprehensive logging** - Integration with @isa/core/logging for debugging
+- **Error resilience** - Graceful error handling with fallback responses
+
+## Quick Start
+
+### 1. Import and Inject Services
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { CatalougeSearchService, AvailabilityService } from '@isa/catalogue/data-access';
+
+@Component({
+  selector: 'app-product-search',
+  template: '...'
+})
+export class ProductSearchComponent {
+  #catalogueSearch = inject(CatalougeSearchService);
+  #availabilityService = inject(AvailabilityService);
+}
+```
+
+### 2. Search Products by EAN
+
+```typescript
+async searchByEan(): Promise<void> {
+  const items = await this.#catalogueSearch.searchByEans([
+    '1234567890123',
+    '9876543210987'
+  ]);
+
+  // Result: Item[] with product details and availability
+  items.forEach(item => {
+    console.log(`${item.product.name}: ${item.catalogAvailability.price.value.value}€`);
+  });
+}
+```
+
+### 3. Search Products by Term
+
+```typescript
+async searchProducts(): Promise<void> {
+  const abortController = new AbortController();
+
+  const result = await this.#catalogueSearch.searchByTerm(
+    {
+      searchTerm: 'laptop',
+      skip: 0,
+      take: 20
+    },
+    abortController.signal
+  );
+
+  console.log(`Found ${result.total} items`);
+  console.log(`Showing ${result.result.length} items`);
+}
+```
+
+### 4. Search Loyalty Items
+
+```typescript
+async searchLoyaltyItems(): Promise<void> {
+  const abortController = new AbortController();
+
+  const result = await this.#catalogueSearch.searchLoyaltyItems(
+    {
+      filter: { category: 'electronics' },
+      input: { search: 'tablet' },
+      skip: 0,
+      take: 25
+    },
+    abortController.signal
+  );
+
+  // Result includes only loyalty items (praemie = 1-)
+  // Automatically excludes ebooks and downloads (format: !eb;!dl)
+}
+```
+
+### 5. Validate Download Availability
+
+```typescript
+async validateDownloads(cartItems: ShoppingCartItem[]): Promise<void> {
+  const validations = await this.#availabilityService.validateDownloadAvailabilities(
+    cartItems
+  );
+
+  validations.forEach(validation => {
+    if (!validation.isAvailable) {
+      console.log(`Item ${validation.itemId} is not available for download`);
+    } else {
+      console.log(`Item ${validation.itemId} is available`);
+      // validation.availabilityUpdate contains the updated availability data
+    }
+  });
+}
+```
+
+## Core Concepts
+
+### Item Structure
+
+The core `Item` interface extends the generated API DTO with domain-specific properties:
+
+```typescript
+interface Item {
+  id: number;                           // Unique item identifier
+  product: Product;                     // Product details
+  catalogAvailability: Availability;    // Catalog availability data
+  redemptionPoints?: number;            // Loyalty points (for reward items)
+  // ... other fields from ItemDTO
+}
+```
+
+### Product Information
+
+Product details include essential product metadata:
+
+```typescript
+interface Product {
+  name: string;                         // Product name
+  contributors: string;                 // Author/artist/creator
+  catalogProductNumber: string;         // Internal catalog number
+  ean: string;                          // European Article Number (barcode)
+  format: string;                       // Product format (e.g., 'CD', 'DVD', 'Book')
+  formatDetail: string;                 // Detailed format information
+  volume: string;                       // Size/volume description
+  manufacturer: string;                 // Manufacturer/publisher
+  // ... other fields from ProductDTO
+}
+```
+
+### Availability Information
+
+Catalog availability includes pricing and stock data:
+
+```typescript
+interface Availability {
+  price: Price;                         // Current price with VAT
+  // ... other fields from AvailabilityDTO
+}
+
+interface Price {
+  value: PriceValue;                    // Price amount and currency
+  // ... other fields from PriceDTO
+}
+
+interface PriceValue {
+  value: number;                        // Numeric price value
+  // ... other fields from PriceValueDTO
+}
+```
+
+### Query Settings
+
+Loyalty query settings configure search UI:
+
+```typescript
+type QuerySettings = UISettingsDTO;    // Settings from API
+
+// Contains:
+// - filters: Available filter options
+// - orderByOptions: Sort options
+// - other UI configuration
+```
+
+### Search Validation with Zod
+
+All search parameters are validated using Zod schemas:
+
+```typescript
+// Term search validation
+const params = {
+  searchTerm: 'laptop',
+  skip: '0',          // Coerced to number
+  take: '20'          // Coerced to number
+};
+
+// Validation happens automatically
+const result = await service.searchByTerm(params, abortSignal);
+// Throws ZodError if validation fails
+```
+
+## API Reference
+
+### CatalougeSearchService
+
+Main service for searching catalog items and loyalty rewards.
+
+#### `searchByEans(ean, abortSignal?): Promise<Item[]>`
+
+Searches for items by their European Article Numbers (EANs/barcodes).
+
+**Parameters:**
+- `ean: string[]` - Array of EAN codes to search for
+- `abortSignal?: AbortSignal` - Optional abort signal for request cancellation
+
+**Returns:** Promise resolving to array of matching items
+
+**Error Handling:** Returns empty array on error (does not throw)
+
+**Example:**
+```typescript
+const items = await service.searchByEans([
+  '1234567890123',
+  '9876543210987'
+]);
+
+// Result: Item[] (empty if not found or error)
+items.forEach(item => {
+  console.log(`${item.product.name} - ${item.product.ean}`);
+});
+```
+
+#### `searchByTerm(params, abortSignal): Promise<ListResponseArgs<Item>>`
+
+Searches catalog items by search term with pagination support.
+
+**Parameters:**
+- `params: SearchByTermInput` - Search parameters (automatically validated)
+  - `searchTerm: string` - Search query (min 1 character)
+  - `skip?: number` - Number of items to skip (default: 0)
+  - `take?: number` - Number of items to return (default: 20, max: 100)
+- `abortSignal: AbortSignal` - Required abort signal for request cancellation
+
+**Returns:** Promise resolving to paginated search results
+
+**Throws:**
+- `ZodError` - If params validation fails
+- `Error` - If API returns an error
+
+**Example:**
+```typescript
+const abortController = new AbortController();
+
+const result = await service.searchByTerm(
+  {
+    searchTerm: 'mystery novel',
+    skip: 0,
+    take: 50
+  },
+  abortController.signal
+);
+
+console.log(`Found ${result.total} items`);
+console.log(`Page: ${result.result.length} items`);
+```
+
+#### `fetchLoyaltyQuerySettings(): Promise<QuerySettings>`
+
+Fetches UI settings for loyalty item search configuration.
+
+**Returns:** Promise resolving to query settings (undefined on error)
+
+**Error Handling:** Returns undefined on error (does not throw)
+
+**Example:**
+```typescript
+const settings = await service.fetchLoyaltyQuerySettings();
+
+if (settings) {
+  console.log('Available filters:', settings.filters);
+  console.log('Sort options:', settings.orderByOptions);
+}
+```
+
+#### `searchLoyaltyItems(params, abortSignal): Promise<ListResponseArgs<Item>>`
+
+Searches loyalty reward items with automatic loyalty filtering applied.
+
+**Parameters:**
+- `params: QueryTokenInput` - Query parameters (automatically validated)
+  - `filter?: Record<string, any>` - Custom filters (default: {})
+  - `input?: Record<string, string>` - Additional input parameters
+  - `orderBy?: OrderBy[]` - Sort options
+  - `skip?: number` - Pagination offset (default: 0)
+  - `take?: number` - Page size (default: 25)
+- `abortSignal: AbortSignal` - Required abort signal for request cancellation
+
+**Returns:** Promise resolving to paginated loyalty items (undefined on error)
+
+**Automatic Filters Applied:**
+- `format: '!eb;!dl'` - Excludes ebooks and downloads (can be overridden)
+- `praemie: '1-'` - Only loyalty reward items
+
+**Throws:** Returns undefined on error (does not throw)
+
+**Example:**
+```typescript
+const abortController = new AbortController();
+
+const result = await service.searchLoyaltyItems(
+  {
+    filter: { category: 'electronics' },
+    input: { brand: 'samsung' },
+    orderBy: [{ by: 'price', label: 'Price', desc: false, selected: true }],
+    skip: 0,
+    take: 20
+  },
+  abortController.signal
+);
+
+if (result) {
+  console.log(`Loyalty items: ${result.total}`);
+  result.result.forEach(item => {
+    console.log(`${item.product.name}: ${item.redemptionPoints} points`);
+  });
+}
+```
+
+### AvailabilityService
+
+Service for validating product availability for download and delivery order types.
+
+**Note:** This service is focused on availability validation for the catalogue domain. For full availability checking across all order types, use `@isa/availability/data-access`.
+
+#### `validateDownloadAvailabilities(items, abortSignal?): Promise<DownloadAvailabilityValidation[]>`
+
+Validates download item availabilities and returns validation results.
+
+**Parameters:**
+- `items: ShoppingCartItem[]` - Shopping cart items to validate
+- `abortSignal?: AbortSignal` - Optional abort signal for request cancellation
+
+**Returns:** Promise resolving to array of validation results
+
+**Business Rules:**
+- Only processes items with `orderType === 'Download'`
+- Skips items that already have `lastRequest` (already validated)
+- Validates against download-specific status codes: 2, 32, 256, 1024, 2048, 4096
+- Rejects supplier 16 with 0 stock
+
+**Example:**
+```typescript
+const cartItems: ShoppingCartItem[] = [
+  {
+    id: 1,
+    data: {
+      features: { orderType: 'Download' },
+      product: { ean: '123456', catalogProductNumber: 789 },
+      availability: { price: 9.99 }
+    }
+  }
+];
+
+const validations = await service.validateDownloadAvailabilities(cartItems);
+
+validations.forEach(validation => {
+  if (validation.isAvailable) {
+    console.log(`Item ${validation.itemId} available for download`);
+    // Update cart with validation.availabilityUpdate
+  } else {
+    console.log(`Item ${validation.itemId} not available`);
+    // Remove from cart or mark as unavailable
+  }
+});
+```
+
+**Validation Result Structure:**
+```typescript
+interface DownloadAvailabilityValidation {
+  itemId: number;
+  isAvailable: boolean;
+  availabilityUpdate?: {
+    availabilityType: number;
+    ssc: number;
+    sscText: string;
+    supplier: { id: number };
+    isPrebooked: boolean;
+    estimatedShippingDate: string;
+    price: number;
+    lastRequest: string;               // ISO timestamp
+  };
+}
+```
+
+#### `getDigDeliveryAvailability(item, abortSignal?): Promise<any>`
+
+Gets DIG delivery availability for a shopping cart item.
+
+**Parameters:**
+- `item: ShoppingCartItem` - Shopping cart item
+- `abortSignal?: AbortSignal` - Optional abort signal for request cancellation
+
+**Returns:** Promise resolving to availability data or null if not available
+
+**Example:**
+```typescript
+const item: ShoppingCartItem = {
+  id: 1,
+  data: {
+    product: { ean: '123456', catalogProductNumber: 789 },
+    quantity: 2,
+    availability: { price: 15.99 }
+  }
+};
+
+const availability = await service.getDigDeliveryAvailability(item);
+
+if (availability) {
+  console.log(`Available: ${availability.sscText}`);
+  console.log(`Delivery: ${availability.estimatedShippingDate}`);
+  console.log(`Supplier: ${availability.supplier.id}`);
+  console.log(`Logistician: ${availability.logistician.id}`);
+}
+```
+
+**Response Structure:**
+```typescript
+{
+  availabilityType: number;
+  ssc: number;
+  sscText: string;
+  supplier: { id: number };
+  isPrebooked: boolean;
+  estimatedShippingDate: string;
+  estimatedDelivery: string;
+  price: number;
+  logistician: { id: number };
+  supplierProductNumber: string;
+  supplierInfo: string;
+  lastRequest: string;
+  priceMaintained: boolean;
+}
+```
+
+#### `getB2bDeliveryAvailability(item, defaultBranch, logistician, abortSignal?): Promise<any>`
+
+Gets B2B delivery availability for a shopping cart item with branch and logistician context.
+
+**Parameters:**
+- `item: ShoppingCartItem` - Shopping cart item
+- `defaultBranch: Branch` - Default branch for stock lookup
+- `logistician: Logistician` - Logistician data (typically ID 2470)
+- `abortSignal?: AbortSignal` - Optional abort signal for request cancellation
+
+**Returns:** Promise resolving to availability data or null if not available
+
+**Special Handling:**
+- Uses store availability endpoint (not shipping)
+- Calculates total stock across all availabilities
+- Always uses provided logistician ID in response
+
+**Example:**
+```typescript
+const item: ShoppingCartItem = {
+  id: 1,
+  data: {
+    product: { ean: '123456', catalogProductNumber: 789 },
+    quantity: 10,
+    availability: { price: 99.99 }
+  }
+};
+
+const branch = { id: 42, name: 'Main Branch' };
+const logistician = { id: 2470, name: 'Standard Logistician' };
+
+const availability = await service.getB2bDeliveryAvailability(
+  item,
+  branch,
+  logistician
+);
+
+if (availability) {
+  console.log(`In stock: ${availability.inStock} units`);
+  console.log(`Order deadline: ${availability.orderDeadline}`);
+  console.log(`Logistician: ${availability.logistician.id}`);
+}
+```
+
+**Response Structure:**
+```typescript
+{
+  orderDeadline: string;
+  availabilityType: number;
+  ssc: number;
+  sscText: string;
+  supplier: { id: number };
+  isPrebooked: boolean;
+  estimatedShippingDate: string;
+  price: number;
+  inStock: number;                      // Total across all availabilities
+  supplierProductNumber: string;
+  supplierInfo: string;
+  lastRequest: string;
+  priceMaintained: boolean;
+  logistician: { id: number };
+}
+```
+
+### Schema Types
+
+#### SearchByTerm
+
+```typescript
+interface SearchByTermInput {
+  searchTerm: string;                   // Min 1 character
+  skip?: number;                        // Default: 0
+  take?: number;                        // Default: 20, max: 100
+}
+```
+
+#### QueryToken
+
+```typescript
+interface QueryTokenInput {
+  filter?: Record<string, any>;         // Filter criteria
+  input?: Record<string, string>;       // Additional input
+  orderBy?: OrderBy[];                  // Sort options
+  skip?: number;                        // Default: 0
+  take?: number;                        // Default: 25
+}
+
+interface OrderBy {
+  by: string;                           // Field name to sort by
+  label: string;                        // Display label
+  desc: boolean;                        // Descending sort
+  selected: boolean;                    // Currently selected
+}
+```
+
+## Usage Examples
+
+### Basic EAN Search
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { CatalougeSearchService } from '@isa/catalogue/data-access';
+
+@Component({
+  selector: 'app-barcode-scanner',
+  template: '...'
+})
+export class BarcodeScannerComponent {
+  #catalogueSearch = inject(CatalougeSearchService);
+
+  async scanBarcode(ean: string): Promise<void> {
+    const items = await this.#catalogueSearch.searchByEans([ean]);
+
+    if (items.length === 0) {
+      console.log('Item not found in catalog');
+      return;
+    }
+
+    const item = items[0];
+    console.log(`Found: ${item.product.name}`);
+    console.log(`Price: ${item.catalogAvailability.price.value.value}€`);
+    console.log(`Manufacturer: ${item.product.manufacturer}`);
+  }
+}
+```
+
+### Paginated Search with Cancellation
+
+```typescript
+async searchWithPagination(): Promise<void> {
+  const abortController = new AbortController();
+
+  // Cancel after 10 seconds
+  setTimeout(() => abortController.abort(), 10000);
+
+  try {
+    const result = await this.#catalogueSearch.searchByTerm(
+      {
+        searchTerm: 'science fiction',
+        skip: 20,    // Second page (20 items per page)
+        take: 20
+      },
+      abortController.signal
+    );
+
+    console.log(`Total results: ${result.total}`);
+    console.log(`Current page: ${result.result.length} items`);
+    console.log(`Has more: ${result.total > 40}`);
+
+    result.result.forEach((item, index) => {
+      const position = 20 + index + 1;
+      console.log(`${position}. ${item.product.name} by ${item.product.contributors}`);
+    });
+  } catch (error) {
+    console.error('Search cancelled or failed', error);
+  }
+}
+```
+
+### Advanced Loyalty Search with Filtering
+
+```typescript
+async searchLoyaltyWithFilters(): Promise<void> {
+  const abortController = new AbortController();
+
+  // Fetch settings first to understand available filters
+  const settings = await this.#catalogueSearch.fetchLoyaltyQuerySettings();
+
+  if (!settings) {
+    console.error('Failed to load loyalty settings');
+    return;
+  }
+
+  // Search with custom filters
+  const result = await this.#catalogueSearch.searchLoyaltyItems(
+    {
+      filter: {
+        category: 'books',
+        format: 'hardcover',           // Overrides default '!eb;!dl'
+        priceRange: '10-50'
+      },
+      input: {
+        author: 'tolkien',
+        language: 'en'
+      },
+      orderBy: [
+        { by: 'redemptionPoints', label: 'Points', desc: false, selected: true }
+      ],
+      skip: 0,
+      take: 30
+    },
+    abortController.signal
+  );
+
+  if (!result) {
+    console.error('Search failed');
+    return;
+  }
+
+  console.log(`Found ${result.total} loyalty items`);
+
+  result.result.forEach(item => {
+    console.log(
+      `${item.product.name}: ${item.redemptionPoints} points ` +
+      `(€${item.catalogAvailability.price.value.value})`
+    );
+  });
+}
+```
+
+### Download Availability Validation
+
+```typescript
+import { AvailabilityService, ShoppingCartItem } from '@isa/catalogue/data-access';
+
+@Component({
+  selector: 'app-download-cart',
+  template: '...'
+})
+export class DownloadCartComponent {
+  #availabilityService = inject(AvailabilityService);
+
+  async validateCart(cartItems: ShoppingCartItem[]): Promise<void> {
+    const validations = await this.#availabilityService.validateDownloadAvailabilities(
+      cartItems
+    );
+
+    const unavailableItems: number[] = [];
+    const updates = new Map<number, any>();
+
+    validations.forEach(validation => {
+      if (!validation.isAvailable) {
+        unavailableItems.push(validation.itemId);
+      } else if (validation.availabilityUpdate) {
+        updates.set(validation.itemId, validation.availabilityUpdate);
+      }
+    });
+
+    if (unavailableItems.length > 0) {
+      console.log(`Removing ${unavailableItems.length} unavailable items`);
+      // Remove unavailable items from cart
+      this.removeItems(unavailableItems);
+    }
+
+    if (updates.size > 0) {
+      console.log(`Updating availability for ${updates.size} items`);
+      // Update cart items with fresh availability data
+      this.updateAvailabilities(updates);
+    }
+  }
+
+  private removeItems(itemIds: number[]): void {
+    // Implementation to remove items
+  }
+
+  private updateAvailabilities(updates: Map<number, any>): void {
+    // Implementation to update availability data
+  }
+}
+```
+
+### DIG and B2B Availability
+
+```typescript
+async getDeliveryAvailability(
+  item: ShoppingCartItem,
+  orderType: 'DIG-Versand' | 'B2B-Versand'
+): Promise<void> {
+  let availability: any;
+
+  if (orderType === 'DIG-Versand') {
+    availability = await this.#availabilityService.getDigDeliveryAvailability(item);
+  } else {
+    // B2B requires branch and logistician
+    const branch = await this.getBranch();  // Get from branch service
+    const logistician = await this.getLogistician(2470);  // Standard B2B logistician
+
+    availability = await this.#availabilityService.getB2bDeliveryAvailability(
+      item,
+      branch,
+      logistician
+    );
+  }
+
+  if (!availability) {
+    console.log('Item not available for delivery');
+    return;
+  }
+
+  console.log(`Availability: ${availability.sscText}`);
+  console.log(`Delivery date: ${availability.estimatedShippingDate}`);
+  console.log(`Price: ${availability.price}`);
+
+  if (orderType === 'B2B-Versand') {
+    console.log(`In stock: ${availability.inStock}`);
+    console.log(`Order deadline: ${availability.orderDeadline}`);
+  }
+}
+```
+
+### Error-Resilient Search
+
+```typescript
+async searchWithErrorHandling(searchTerm: string): Promise<void> {
+  const abortController = new AbortController();
+
+  try {
+    const result = await this.#catalogueSearch.searchByTerm(
+      {
+        searchTerm,
+        skip: 0,
+        take: 20
+      },
+      abortController.signal
+    );
+
+    if (result.error) {
+      console.error('Search returned error:', result.message);
+      return;
+    }
+
+    this.displayResults(result.result);
+  } catch (error) {
+    if (error instanceof ZodError) {
+      console.error('Invalid search parameters:', error.errors);
+      this.showValidationError(error);
+    } else {
+      console.error('Search failed:', error);
+      this.showGenericError();
+    }
+  }
+}
+```
+
+## Search Types
+
+### EAN Search
+
+Searches by European Article Number (barcode).
+
+**Characteristics:**
+- No pagination (returns all matches)
+- Returns empty array on error
+- Can search multiple EANs simultaneously
+- Fast and exact matching
+
+**Use Cases:**
+- Barcode scanning
+- Direct product lookup
+- Batch item retrieval
+
+### Term Search
+
+Full-text search across catalog.
+
+**Characteristics:**
+- Pagination support (skip/take)
+- Throws errors on API failure
+- Requires AbortSignal
+- Tracks search analytics (doNotTrack: true)
+
+**Use Cases:**
+- Product search interface
+- Auto-complete suggestions
+- Browse functionality
+
+### Loyalty Search
+
+Specialized search for loyalty reward items.
+
+**Characteristics:**
+- Automatic loyalty filters applied
+- Supports advanced filtering and sorting
+- Custom filter merging
+- Returns undefined on error
+
+**Automatic Filters:**
+- `format: '!eb;!dl'` - Excludes ebooks and downloads
+- `praemie: '1-'` - Only loyalty items
+
+**Use Cases:**
+- Reward catalog browsing
+- Points redemption interface
+- Loyalty program administration
+
+## Availability Validation
+
+### Download Validation
+
+Downloads have strict availability requirements:
+
+**Valid Status Codes:**
+```typescript
+const VALID_DOWNLOAD_CODES = [
+  2,      // PrebookAtBuyer
+  32,     // PrebookAtRetailer
+  256,    // PrebookAtSupplier
+  1024,   // Available
+  2048,   // OnDemand
+  4096    // AtProductionDate
+];
+```
+
+**Special Rules:**
+- Supplier 16 with 0 stock = unavailable
+- Must have one of the valid status codes
+- Quantity always forced to 1
+- Only validates items without `lastRequest`
+
+### DIG Delivery
+
+Standard digital shipping availability.
+
+**Characteristics:**
+- Uses shipping availability endpoint
+- Returns preferred availability
+- Includes supplier and logistician data
+- Estimated delivery date calculation
+
+**Date Selection:**
+```typescript
+// If requestStatusCode === '32', use altAt
+// Otherwise use at
+estimatedShippingDate: requestStatusCode === '32' ? altAt : at
+```
+
+### B2B Delivery
+
+Business-to-business shipping with branch context.
+
+**Characteristics:**
+- Uses store availability endpoint
+- Requires branch and logistician context
+- Calculates total stock across all availabilities
+- Includes order deadline
+
+**Stock Calculation:**
+```typescript
+// Sum quantities from all availabilities
+inStock = availabilities.reduce((sum, av) => sum + (av?.qty || 0), 0)
+```
+
+## Validation and Business Rules
+
+### Zod Schema Validation
+
+All parameters are validated using Zod schemas before processing:
+
+**Type Coercion:**
+```typescript
+// Number coercion
+{ skip: '10' }  →  { skip: 10 }
+{ take: '20' }  →  { take: 20 }
+
+// Validation constraints
+searchTerm: z.string().min(1)                    // Required, non-empty
+skip: z.number().int().min(0).default(0)         // Non-negative integer
+take: z.number().int().min(1).max(100).default(20)  // Between 1 and 100
+```
+
+**Default Values:**
+```typescript
+// SearchByTermSchema
+skip: 0
+take: 20
+
+// QueryTokenSchema
+filter: {}
+skip: 0
+take: 25
+orderBy: []
+```
+
+### Loyalty Filter Rules
+
+Loyalty searches apply automatic filters:
+
+```typescript
+// Base loyalty filter
+{
+  format: '!eb;!dl',    // Exclude ebooks and downloads
+  praemie: '1-'         // Only loyalty items
+}
+
+// Custom filters are merged (custom overrides base)
+customFilter = { category: 'books', format: 'hardcover' }
+→ finalFilter = { format: 'hardcover', praemie: '1-', category: 'books' }
+```
+
+### Download Availability Rules
+
+Downloads are validated against specific business rules:
+
+1. **Status Code Validation**
+   ```typescript
+   // Only these codes are valid for downloads
+   [2, 32, 256, 1024, 2048, 4096].includes(availability.status)
+   ```
+
+2. **Supplier 16 Stock Rule**
+   ```typescript
+   // Supplier 16 with 0 stock = unavailable
+   if (availability.supplierId === 16 && availability.inStock === 0) {
+     return false;
+   }
+   ```
+
+3. **Last Request Check**
+   ```typescript
+   // Skip items already validated
+   if (item.data?.availability?.lastRequest) {
+     return;  // Skip validation
+   }
+   ```
+
+## Error Handling
+
+### Error Types
+
+#### ZodError
+
+Thrown when input parameters fail validation:
+
+```typescript
+import { ZodError } from 'zod';
+
+try {
+  await service.searchByTerm(
+    {
+      searchTerm: '',      // Empty string fails min(1)
+      skip: -1,            // Negative fails min(0)
+      take: 150            // Exceeds max(100)
+    },
+    abortSignal
+  );
+} catch (error) {
+  if (error instanceof ZodError) {
+    console.error('Validation errors:', error.errors);
+    // error.errors contains detailed validation failures
+    error.errors.forEach(err => {
+      console.log(`${err.path}: ${err.message}`);
+    });
+  }
+}
+```
+
+#### Error (Generic)
+
+Thrown by searchByTerm when API returns an error:
+
+```typescript
+try {
+  const result = await service.searchByTerm(params, abortSignal);
+} catch (error) {
+  if (error instanceof Error) {
+    console.error('Search failed:', error.message);
+    // Display user-friendly error message
+  }
+}
+```
+
+### Error Recovery Patterns
+
+#### searchByEans - Graceful Degradation
+
+```typescript
+const items = await service.searchByEans(['invalid-ean']);
+// Returns: []
+// Does not throw - safe to use without try/catch
+```
+
+#### fetchLoyaltyQuerySettings - Undefined Return
+
+```typescript
+const settings = await service.fetchLoyaltyQuerySettings();
+// Returns: undefined on error
+// Always check for undefined:
+if (settings) {
+  // Use settings
+} else {
+  // Use default UI configuration
+}
+```
+
+#### searchLoyaltyItems - Undefined Return
+
+```typescript
+const result = await service.searchLoyaltyItems(params, abortSignal);
+// Returns: undefined on error
+// Always check:
+if (result) {
+  // Display results
+} else {
+  // Show error message
+}
+```
+
+### Request Cancellation
+
+All methods support AbortSignal for cancellation:
+
+```typescript
+const controller = new AbortController();
+
+// Set timeout
+const timeoutId = setTimeout(() => {
+  controller.abort();
+  console.log('Search cancelled due to timeout');
+}, 5000);
+
+try {
+  const result = await service.searchByTerm(
+    params,
+    controller.signal
+  );
+  clearTimeout(timeoutId);
+  // Process result
+} catch (error) {
+  clearTimeout(timeoutId);
+  // Handle cancellation or other errors
+}
+```
+
+### Logging Context
+
+The service automatically logs errors with context:
+
+```typescript
+// Logged automatically for searchByEans
+{
+  service: 'CatalougeSearchService',
+  method: 'searchByEans',
+  eanCount: 3
+}
+
+// Logged for availability validation
+{
+  service: 'AvailabilityService',
+  method: 'getDigDeliveryAvailability',
+  itemId: 123
+}
+```
+
+## Testing
+
+The library uses **Jest** with **Angular Testing Utilities** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test catalogue-data-access --skip-nx-cache
+
+# Run tests with coverage
+npx nx test catalogue-data-access --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test catalogue-data-access --watch
+```
+
+### Test Structure
+
+The library includes comprehensive unit tests covering:
+
+**CatalougeSearchService Tests:**
+- **EAN search** - Single/multiple EANs, empty results, error handling
+- **Term search** - Pagination, validation, abort signal, default values
+- **Loyalty settings** - Success/error scenarios, HTTP errors
+- **Loyalty search** - Filtering, sorting, filter merging, error handling
+
+**AvailabilityService Tests:**
+- **Download validation** - Status codes, supplier rules, abort signal
+- **DIG delivery** - Success/error scenarios, preferred selection
+- **B2B delivery** - Stock calculation, branch context, logistician override
+
+### Example Test (Jest with Angular Testing Utilities)
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { CatalougeSearchService } from './catalouge-search.service';
+import { SearchService } from '@generated/swagger/cat-search-api';
+import { of } from 'rxjs';
+
+describe('CatalougeSearchService', () => {
+  let service: CatalougeSearchService;
+  let searchServiceSpy: jest.Mocked<SearchService>;
+
+  beforeEach(() => {
+    const searchServiceMock = {
+      SearchByEAN: jest.fn(),
+      SearchSearch: jest.fn(),
+      SearchLoyaltySettings: jest.fn(),
+    };
+
+    TestBed.configureTestingModule({
+      providers: [
+        CatalougeSearchService,
+        { provide: SearchService, useValue: searchServiceMock },
+      ],
+    });
+
+    service = TestBed.inject(CatalougeSearchService);
+    searchServiceSpy = TestBed.inject(SearchService) as jest.Mocked<SearchService>;
+  });
+
+  it('should return items when search is successful', async () => {
+    // Arrange
+    const mockItems = [
+      { id: 1, product: { name: 'Item 1' } },
+      { id: 2, product: { name: 'Item 2' } }
+    ];
+    const mockResponse = { error: false, result: mockItems };
+    searchServiceSpy.SearchByEAN.mockReturnValue(of(mockResponse));
+
+    // Act
+    const result = await service.searchByEans(['123', '456']);
+
+    // Assert
+    expect(result).toEqual(mockItems);
+    expect(searchServiceSpy.SearchByEAN).toHaveBeenCalledWith(['123', '456']);
+  });
+});
+```
+
+### Example Test (Spectator - Legacy Pattern)
+
+```typescript
+import { createServiceFactory, SpectatorService } from '@ngneat/spectator/jest';
+import { AvailabilityService } from './availability.service';
+import { AvailabilityService as GeneratedAvailabilityService } from '@generated/swagger/availability-api';
+import { of } from 'rxjs';
+
+describe('AvailabilityService', () => {
+  let spectator: SpectatorService<AvailabilityService>;
+  const createService = createServiceFactory({
+    service: AvailabilityService,
+    mocks: [GeneratedAvailabilityService],
+  });
+
+  beforeEach(() => {
+    spectator = createService();
+  });
+
+  it('should validate download availability', async () => {
+    // Arrange
+    const items = [{
+      id: 1,
+      data: {
+        features: { orderType: 'Download' },
+        product: { ean: '123456' }
+      }
+    }];
+    const mockResponse = {
+      error: false,
+      result: [{ preferred: 1, status: 2 }]  // Valid status
+    };
+    const availabilityService = spectator.inject(GeneratedAvailabilityService);
+    availabilityService.AvailabilityShippingAvailability.mockReturnValue(of(mockResponse));
+
+    // Act
+    const result = await spectator.service.validateDownloadAvailabilities(items);
+
+    // Assert
+    expect(result).toHaveLength(1);
+    expect(result[0].isAvailable).toBe(true);
+  });
+});
+```
+
+## Architecture Notes
+
+### Current Architecture
+
+The library follows a layered architecture:
+
+```
+Components/Features
+       ↓
+CatalougeSearchService (search operations)
+       ↓
+├─→ Generated SearchService (cat-search-api)
+└─→ Schema validation (Zod)
+
+Components/Features
+       ↓
+AvailabilityService (availability validation)
+       ↓
+├─→ Generated AvailabilityService (availability-api)
+└─→ Download validation logic
+```
+
+### Domain Model
+
+The library extends generated API DTOs with domain types:
+
+```typescript
+// Generated DTO (from cat-search-api)
+interface ItemDTO {
+  // Generated fields from API
+}
+
+// Domain Model (this library)
+interface Item extends ItemDTO {
+  id: number;
+  product: Product;
+  catalogAvailability: Availability;
+  redemptionPoints?: number;
+}
+```
+
+**Benefits:**
+- Type safety across application layers
+- Clear separation of API and domain concerns
+- Flexibility to add domain-specific fields
+- Easier to mock in tests
+
+### Service Responsibilities
+
+#### CatalougeSearchService
+
+**Responsibilities:**
+- Execute catalog search operations
+- Validate input parameters with Zod
+- Transform API responses to domain models
+- Handle errors gracefully
+- Log operations for debugging
+
+**Not Responsible For:**
+- State management (use NgRx or signals in features)
+- UI presentation logic
+- Business workflows (handled by facades/features)
+
+#### AvailabilityService
+
+**Responsibilities:**
+- Validate download item availability
+- Fetch DIG and B2B delivery availability
+- Apply download-specific business rules
+- Transform availability responses
+
+**Not Responsible For:**
+- Full availability checking (see @isa/availability/data-access)
+- Order type routing
+- Branch/logistician management
+
+### Known Architectural Considerations
+
+#### 1. Shared Availability Concerns
+
+The `AvailabilityService` in this library duplicates some functionality from `@isa/availability/data-access`:
+
+**Current State:**
+- Both libraries have availability validation logic
+- Download validation is specific to catalogue domain
+- DIG/B2B methods are specialized for cart items
+
+**Recommendation:**
+- Consider consolidating availability logic in `@isa/availability/data-access`
+- Keep catalogue-specific validation in this library
+- Use composition to delegate to availability service
+
+**Impact:** Would reduce code duplication and improve maintainability
+
+#### 2. Error Handling Inconsistency
+
+Different methods use different error handling strategies:
+
+**Current State:**
+- `searchByEans`: Returns empty array on error
+- `searchByTerm`: Throws error
+- `searchLoyaltyItems`: Returns undefined on error
+
+**Recommendation:**
+- Standardize error handling approach
+- Consider using Result<T, E> pattern
+- Document error behavior clearly in JSDoc
+
+**Impact:** Would improve API consistency and developer experience
+
+#### 3. Shopping Cart Item Interface
+
+The `ShoppingCartItem` interface is defined in this library but represents shopping cart domain:
+
+**Current State:**
+- Interface duplicated across multiple libraries
+- Couples catalogue to shopping cart structure
+
+**Proposed Solution:**
+- Move `ShoppingCartItem` to `@isa/checkout/data-access`
+- Use minimal interface in catalogue library
+- Depend on checkout types where needed
+
+**Impact:** Improves domain boundaries and reduces duplication
+
+### Performance Considerations
+
+1. **Batch EAN Search** - Single API call for multiple EANs (efficient)
+2. **Early Validation** - Zod validation fails fast before API calls
+3. **Pagination Support** - Prevents loading excessive data
+4. **Request Cancellation** - AbortSignal prevents wasted bandwidth
+5. **Error Resilience** - Graceful degradation for non-critical failures
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Caching Layer** - Cache search results for repeated queries
+2. **Search Debouncing** - Built-in debounce for term searches
+3. **Retry Logic** - Automatic retry for transient failures
+4. **Analytics Integration** - Track search patterns and performance
+5. **Type Narrowing** - Use discriminated unions for different search types
+6. **Batch Availability** - Validate multiple items in single request
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework
+- `@generated/swagger/cat-search-api` - Generated catalogue search API client
+- `@generated/swagger/availability-api` - Generated availability API client
+- `@isa/common/data-access` - Common data access utilities, error handling
+- `@isa/core/logging` - Logging service
+- `zod` - Schema validation
+- `rxjs` - Reactive programming
+
+### Development Dependencies
+
+- `@angular/core/testing` - Angular testing utilities
+- `jest` - Test framework
+- `@ngneat/spectator` - Testing utilities (legacy, being phased out)
+
+### Path Alias
+
+Import from: `@isa/catalogue/data-access`
+
+## Best Practices
+
+### When to Use This Library
+
+**Use for:**
+- Product catalog search functionality
+- Loyalty reward item browsing
+- Download availability validation
+- DIG/B2B delivery availability checks
+
+**Don't Use for:**
+- Full availability checking across all order types (use `@isa/availability/data-access`)
+- Shopping cart management (use `@isa/checkout/data-access`)
+- Product details display (use feature libraries)
+
+### Service Injection Pattern
+
+```typescript
+// Modern pattern with inject()
+#catalogueSearch = inject(CatalougeSearchService);
+#availabilityService = inject(AvailabilityService);
+
+// Not: constructor injection (unless required for legacy compatibility)
+```
+
+### Error Handling Best Practices
+
+```typescript
+// Always handle searchByTerm errors (throws)
+try {
+  const result = await service.searchByTerm(params, signal);
+  // Process result
+} catch (error) {
+  // Handle error
+}
+
+// Check for undefined with searchLoyaltyItems
+const result = await service.searchLoyaltyItems(params, signal);
+if (result) {
+  // Process result
+} else {
+  // Handle error state
+}
+
+// searchByEans is safe without try/catch
+const items = await service.searchByEans(['123']);
+if (items.length === 0) {
+  // Handle not found
+}
+```
+
+### AbortSignal Usage
+
+```typescript
+// Create controller at component level
+#abortController?: AbortController;
+
+// Reset on new search
+startSearch(): void {
+  this.#abortController?.abort();
+  this.#abortController = new AbortController();
+
+  this.search(this.#abortController.signal);
+}
+
+// Clean up on destroy
+ngOnDestroy(): void {
+  this.#abortController?.abort();
+}
+```
+
+### Validation Pattern
+
+```typescript
+// Let Zod handle validation - don't pre-validate
+// Good:
+const result = await service.searchByTerm(
+  { searchTerm: userInput, skip: 0, take: 20 },
+  signal
+);
+
+// Bad - unnecessary pre-validation:
+if (userInput && userInput.length > 0) {
+  const result = await service.searchByTerm(...);
+}
+```
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/catalogue/data-access/src/lib/schemas/query-token.schema.ts b/libs/catalogue/data-access/src/lib/schemas/query-token.schema.ts
index 2628026fc..a408c0044 100644
--- a/libs/catalogue/data-access/src/lib/schemas/query-token.schema.ts
+++ b/libs/catalogue/data-access/src/lib/schemas/query-token.schema.ts
@@ -5,10 +5,10 @@ import { z } from 'zod';
  * Used for sorting search results.
  */
 export const OrderBySchema = z.object({
-  by: z.string(), // Field name to sort by
-  label: z.string(), // Display label for the sort option
-  desc: z.boolean(), // Whether sorting is descending
-  selected: z.boolean(), // Whether this sort option is currently selected
+  by: z.string().describe('Field name to sort by'),
+  label: z.string().describe('Display label for the sort option'),
+  desc: z.boolean().describe('Whether sorting is descending'),
+  selected: z.boolean().describe('Whether this sort option is currently selected'),
 });
 
 /**
@@ -16,11 +16,11 @@ export const OrderBySchema = z.object({
  * Used for search operations to ensure consistent query structure.
  */
 export const QueryTokenSchema = z.object({
-  filter: z.record(z.any()).default({}), // Filter criteria as key-value pairs
-  input: z.record(z.string()).default({}).optional(),
-  orderBy: z.array(OrderBySchema).default([]).optional(), // Sorting parameters
-  skip: z.number().default(0),
-  take: z.number().default(25),
+  filter: z.record(z.any()).describe('Filter criteria as key-value pairs').default({}),
+  input: z.record(z.string()).describe('Input parameters as key-value pairs').default({}).optional(),
+  orderBy: z.array(OrderBySchema).describe('Sorting parameters').default([]).optional(),
+  skip: z.number().describe('Number of items to skip for pagination').default(0),
+  take: z.number().describe('Number of items to return per page').default(25),
 });
 
 /**
diff --git a/libs/checkout/data-access/README.md b/libs/checkout/data-access/README.md
index 12ecafa31..7f109cc9e 100644
--- a/libs/checkout/data-access/README.md
+++ b/libs/checkout/data-access/README.md
@@ -1,7 +1,791 @@
-# data-access
+# @isa/checkout/data-access
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive checkout and shopping cart management library for Angular applications supporting multiple order types, reward redemption, and complex multi-step checkout workflows across retail and e-commerce operations.
 
-## Running unit tests
+## Overview
 
-Run `nx test data-access` to execute the unit tests.
+The Checkout Data Access library provides the complete infrastructure for managing shopping carts, reward catalogs, and checkout processes. It handles six distinct order types (in-store pickup, customer pickup, standard shipping, digital shipping, B2B shipping, and digital downloads), reward/loyalty redemption flows, customer/payer data transformation, and multi-phase checkout orchestration with automatic availability validation and destination management.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Order Types](#order-types)
+- [Checkout Flow](#checkout-flow)
+- [Reward System](#reward-system)
+- [Data Transformation](#data-transformation)
+- [Error Handling](#error-handling)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Shopping Cart Management** - Create, update, and manage shopping carts with full CRUD operations
+- **Six Order Type Support** - InStore (Rücklage), Pickup (Abholung), Delivery (Versand), DIG-Versand, B2B-Versand, Download
+- **Reward Catalog Store** - NgRx Signals store for managing reward items and selections with tab isolation
+- **Complete Checkout Orchestration** - 13-step checkout workflow with automatic validation and transformation
+- **CRM Data Integration** - Seamless conversion between CRM and checkout-api formats
+- **Multi-Domain Adapters** - 8 specialized adapters for cross-domain data transformation
+- **Zod Validation** - Runtime schema validation for 58+ schemas
+- **Payment Type Determination** - Automatic payment type selection (FREE/CASH/INVOICE) based on order analysis
+- **Availability Validation** - Integrated download validation and shipping availability updates
+- **Destination Management** - Automatic shipping address updates and logistician assignment
+- **Session Persistence** - Reward catalog state persists across browser sessions
+- **Request Cancellation** - AbortSignal support for all async operations
+- **Comprehensive Error Handling** - Typed CheckoutCompletionError with specific error codes
+- **Tab Isolation** - Shopping carts and reward selections scoped per browser tab
+- **Business Logic Helpers** - 15+ pure functions for order analysis and validation
+
+## Quick Start
+
+### 1. Shopping Cart Operations
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { ShoppingCartFacade } from '@isa/checkout/data-access';
+
+@Component({
+  selector: 'app-checkout',
+  template: '...'
+})
+export class CheckoutComponent {
+  #shoppingCartFacade = inject(ShoppingCartFacade);
+
+  async createCart(): Promise<void> {
+    // Create new shopping cart
+    const cart = await this.#shoppingCartFacade.createShoppingCart();
+    console.log('Cart created:', cart.id);
+
+    // Get shopping cart
+    const existingCart = await this.#shoppingCartFacade.getShoppingCart(cart.id!);
+    console.log('Cart items:', existingCart?.items?.length);
+  }
+}
+```
+
+### 2. Complete Checkout with CRM Data
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { ShoppingCartFacade } from '@isa/checkout/data-access';
+import { CustomerResource } from '@isa/crm/data-access';
+
+@Component({
+  selector: 'app-complete-checkout',
+  template: '...'
+})
+export class CompleteCheckoutComponent {
+  #shoppingCartFacade = inject(ShoppingCartFacade);
+  #customerResource = inject(CustomerResource);
+
+  async completeCheckout(shoppingCartId: number): Promise<void> {
+    // Fetch customer from CRM
+    const customer = await this.#customerResource.value();
+
+    if (!customer) {
+      throw new Error('Customer not found');
+    }
+
+    // Complete checkout with automatic CRM data transformation
+    const orders = await this.#shoppingCartFacade.completeWithCrmData({
+      shoppingCartId,
+      crmCustomer: customer,
+      crmShippingAddress: customer.shippingAddresses?.[0]?.data,
+      crmPayer: customer.payers?.[0]?.payer?.data,
+      notificationChannels: customer.notificationChannels ?? 1,
+      specialComment: 'Please handle with care'
+    });
+
+    console.log('Orders created:', orders.length);
+    orders.forEach(order => {
+      console.log(`Order ${order.orderNumber}: ${order.orderType}`);
+    });
+  }
+}
+```
+
+### 3. Reward Catalog Management
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { RewardCatalogStore } from '@isa/checkout/data-access';
+import { Item } from '@isa/catalogue/data-access';
+
+@Component({
+  selector: 'app-reward-selection',
+  template: '...'
+})
+export class RewardSelectionComponent {
+  #rewardCatalogStore = inject(RewardCatalogStore);
+
+  // Access reactive signals
+  items = this.#rewardCatalogStore.items;
+  selectedItems = this.#rewardCatalogStore.selectedItems;
+  hits = this.#rewardCatalogStore.hits;
+
+  selectReward(itemId: number, item: Item): void {
+    this.#rewardCatalogStore.selectItem(itemId, item);
+  }
+
+  removeReward(itemId: number): void {
+    this.#rewardCatalogStore.removeItem(itemId);
+  }
+
+  clearAllSelections(): void {
+    this.#rewardCatalogStore.clearSelectedItems();
+  }
+}
+```
+
+### 4. Adding Items to Shopping Cart
+
+```typescript
+import { ShoppingCartService } from '@isa/checkout/data-access';
+
+@Component({
+  selector: 'app-add-to-cart',
+  template: '...'
+})
+export class AddToCartComponent {
+  #shoppingCartService = inject(ShoppingCartService);
+
+  async addItemsToCart(shoppingCartId: number): Promise<void> {
+    // Check if items can be added first
+    const canAddResults = await this.#shoppingCartService.canAddItems({
+      shoppingCartId,
+      payload: [
+        { itemId: 123, quantity: 2 },
+        { itemId: 456, quantity: 1 }
+      ]
+    });
+
+    // Process results
+    canAddResults.forEach(result => {
+      if (result.canAdd) {
+        console.log(`Item ${result.itemId} can be added`);
+      } else {
+        console.log(`Item ${result.itemId} cannot be added: ${result.reason}`);
+      }
+    });
+
+    // Add items to cart
+    const updatedCart = await this.#shoppingCartService.addItem({
+      shoppingCartId,
+      items: [
+        {
+          destination: { target: 2 },
+          product: {
+            id: 123,
+            catalogProductNumber: 'PROD-123',
+            description: 'Sample Product'
+          },
+          availability: {
+            price: {
+              value: { value: 29.99, currency: 'EUR' },
+              vat: { value: 4.78, inPercent: 19 }
+            }
+          },
+          quantity: 2
+        }
+      ]
+    });
+
+    console.log('Updated cart:', updatedCart.items?.length);
+  }
+}
+```
+
+## Core Concepts
+
+### Order Types
+
+The library supports six distinct order types, each with specific characteristics and handling requirements:
+
+#### 1. InStore (Rücklage)
+- **Purpose**: In-store reservation for later pickup
+- **Characteristics**: Branch-based, no shipping required
+- **Payment**: Cash (4)
+- **Features**: `{ orderType: 'Rücklage' }`
+
+#### 2. Pickup (Abholung)
+- **Purpose**: Customer pickup at branch location
+- **Characteristics**: Branch-based, customer collects items
+- **Payment**: Cash (4)
+- **Features**: `{ orderType: 'Abholung' }`
+
+#### 3. Delivery (Versand)
+- **Purpose**: Standard shipping to customer address
+- **Characteristics**: Requires shipping address, logistician assignment
+- **Payment**: Invoice (128)
+- **Features**: `{ orderType: 'Versand' }`
+
+#### 4. Digital Shipping (DIG-Versand)
+- **Purpose**: Digital delivery for webshop customers
+- **Characteristics**: Requires special availability validation
+- **Payment**: Invoice (128)
+- **Features**: `{ orderType: 'DIG-Versand' }`
+
+#### 5. B2B Shipping (B2B-Versand)
+- **Purpose**: Business-to-business delivery
+- **Characteristics**: Requires logistician 2470, default branch
+- **Payment**: Invoice (128)
+- **Features**: `{ orderType: 'B2B-Versand' }`
+
+#### 6. Download
+- **Purpose**: Digital product downloads
+- **Characteristics**: Requires download availability validation
+- **Payment**: Invoice (128) or Free (2) for loyalty
+- **Features**: `{ orderType: 'Download' }`
+
+### Shopping Cart State
+
+```typescript
+interface ShoppingCart {
+  id?: number;                              // Shopping cart ID
+  items?: EntityContainer<ShoppingCartItem>[]; // Cart items with metadata
+  createdAt?: string;                       // Creation timestamp
+  updatedAt?: string;                       // Last update timestamp
+  features?: Record<string, string>;        // Custom features/flags
+}
+
+interface ShoppingCartItem {
+  id?: number;                              // Item ID in cart
+  destination?: Destination;                // Shipping/pickup destination
+  product?: Product;                        // Product information
+  availability?: OlaAvailability;           // Availability and pricing
+  quantity: number;                         // Item quantity
+  loyalty?: Loyalty;                        // Loyalty points/rewards
+  promotion?: Promotion;                    // Applied promotions
+  features?: Record<string, string>;        // Item features (orderType, etc.)
+  specialComment?: string;                  // Item-specific instructions
+}
+```
+
+### Checkout Flow Overview
+
+The checkout completion process consists of 13 coordinated steps:
+
+```
+1. Fetch and validate shopping cart
+2. Analyze order types (delivery, pickup, download, etc.)
+3. Analyze customer type (B2B, online, guest, staff)
+4. Determine if payer is required
+5. Create or refresh checkout entity
+6. Update destinations for customer (if needed)
+7. Set special comments on items (if provided)
+8. Validate download availabilities
+9. Update shipping availabilities (DIG-Versand, B2B-Versand)
+10. Set buyer on checkout
+11. Set notification channels
+12. Set payer (if required)
+13. Set payment type (FREE/CASH/INVOICE)
+14. Update destination shipping addresses (if delivery)
+
+Result: checkoutId → Pass to OrderCreationFacade for order creation
+```
+
+### Payment Type Logic
+
+Payment type is automatically determined based on order analysis:
+
+```typescript
+/**
+ * Payment type decision tree:
+ *
+ * IF all items have loyalty.value > 0:
+ *   → FREE (2) - Loyalty redemption
+ *
+ * ELSE IF hasDelivery OR hasDownload OR hasDigDelivery OR hasB2BDelivery:
+ *   → INVOICE (128) - Invoicing required
+ *
+ * ELSE:
+ *   → CASH (4) - In-store payment
+ */
+const PaymentTypes = {
+  FREE: 2,      // Loyalty/reward orders
+  CASH: 4,      // In-store pickup/take away
+  INVOICE: 128  // Delivery and download orders
+};
+```
+
+### Order Options Analysis
+
+The library analyzes shopping cart items to determine checkout requirements:
+
+```typescript
+interface OrderOptionsAnalysis {
+  hasTakeAway: boolean;        // Has Rücklage items
+  hasPickUp: boolean;          // Has Abholung items
+  hasDownload: boolean;        // Has Download items
+  hasDelivery: boolean;        // Has Versand items
+  hasDigDelivery: boolean;     // Has DIG-Versand items
+  hasB2BDelivery: boolean;     // Has B2B-Versand items
+  items: ShoppingCartItem[];   // Unwrapped items for processing
+}
+```
+
+**Business Rules:**
+- **Payer Required**: B2B customers OR any delivery/download orders
+- **Destination Update Required**: Any delivery or download orders
+- **Payment Type**: Determined by order types and loyalty status
+- **Shipping Address Required**: Any delivery orders (Versand, DIG-Versand, B2B-Versand)
+
+### Customer Type Analysis
+
+Customer features are analyzed to determine handling requirements:
+
+```typescript
+interface CustomerTypeAnalysis {
+  isOnline: boolean;          // Webshop customer
+  isGuest: boolean;           // Guest account
+  isB2B: boolean;             // Business customer
+  hasCustomerCard: boolean;   // Loyalty card holder (Pay4More)
+  isStaff: boolean;           // Employee/staff member
+}
+```
+
+**Feature Mapping:**
+- `webshop` → `isOnline: true`
+- `guest` → `isGuest: true`
+- `b2b` → `isB2B: true`
+- `p4mUser` → `hasCustomerCard: true`
+- `staff` → `isStaff: true`
+
+### Reward System Architecture
+
+The reward catalog store manages reward items and selections with automatic tab isolation:
+
+```typescript
+interface RewardCatalogEntity {
+  tabId: number;                           // Browser tab ID (isolation)
+  items: Item[];                           // Available reward items
+  hits: number;                            // Total search results
+  selectedItems: Record<number, Item>;     // Selected items by ID
+}
+```
+
+**Key Features:**
+- **Tab Isolation**: Each browser tab has independent reward state
+- **Session Persistence**: State survives browser refreshes
+- **Orphan Cleanup**: Automatically removes state when tabs close
+- **Reactive Signals**: Computed signals for active tab data
+- **Dual Shopping Carts**: Separate carts for regular and reward items
+
+## API Reference
+
+### ShoppingCartFacade
+
+Main facade for shopping cart and checkout operations.
+
+#### `createShoppingCart(): Promise<ShoppingCart>`
+
+Creates a new empty shopping cart.
+
+**Returns:** Promise resolving to the created shopping cart
+
+**Example:**
+```typescript
+const cart = await facade.createShoppingCart();
+console.log('Cart ID:', cart.id);
+```
+
+#### `getShoppingCart(shoppingCartId, abortSignal?): Promise<ShoppingCart | undefined>`
+
+Fetches an existing shopping cart by ID.
+
+**Parameters:**
+- `shoppingCartId: number` - ID of the shopping cart to fetch
+- `abortSignal?: AbortSignal` - Optional cancellation signal
+
+**Returns:** Promise resolving to the shopping cart, or undefined if not found
+
+**Throws:**
+- `ResponseArgsError` - If API returns an error
+
+**Example:**
+```typescript
+const cart = await facade.getShoppingCart(123, abortController.signal);
+if (cart) {
+  console.log('Items:', cart.items?.length);
+}
+```
+
+#### `removeItem(params): Promise<ShoppingCart>`
+
+Removes an item from the shopping cart (sets quantity to 0).
+
+**Parameters:**
+- `params: RemoveShoppingCartItemParams`
+  - `shoppingCartId: number` - Shopping cart ID
+  - `shoppingCartItemId: number` - Item ID to remove
+
+**Returns:** Promise resolving to updated shopping cart
+
+**Throws:**
+- `ZodError` - If params validation fails
+- `ResponseArgsError` - If API returns an error
+
+**Example:**
+```typescript
+const updatedCart = await facade.removeItem({
+  shoppingCartId: 123,
+  shoppingCartItemId: 456
+});
+```
+
+#### `updateItem(params): Promise<ShoppingCart>`
+
+Updates a shopping cart item (quantity, special comment, etc.).
+
+**Parameters:**
+- `params: UpdateShoppingCartItemParams`
+  - `shoppingCartId: number` - Shopping cart ID
+  - `shoppingCartItemId: number` - Item ID to update
+  - `values: UpdateShoppingCartItemDTO` - Fields to update
+
+**Returns:** Promise resolving to updated shopping cart
+
+**Throws:**
+- `ZodError` - If params validation fails
+- `ResponseArgsError` - If API returns an error
+
+**Example:**
+```typescript
+const updatedCart = await facade.updateItem({
+  shoppingCartId: 123,
+  shoppingCartItemId: 456,
+  values: { quantity: 5, specialComment: 'Gift wrap please' }
+});
+```
+
+#### `complete(params, abortSignal?): Promise<Order[]>`
+
+Completes checkout and creates orders.
+
+**Parameters:**
+- `params: CompleteOrderParams`
+  - `shoppingCartId: number` - Shopping cart to process
+  - `buyer: Buyer` - Buyer information
+  - `notificationChannels?: NotificationChannel` - Communication channels
+  - `customerFeatures: Record<string, string>` - Customer feature flags
+  - `payer?: Payer` - Payer information (required for B2B/delivery/download)
+  - `shippingAddress?: ShippingAddress` - Shipping address (required for delivery)
+  - `specialComment?: string` - Special instructions
+- `abortSignal?: AbortSignal` - Optional cancellation signal
+
+**Returns:** Promise resolving to array of created orders
+
+**Throws:**
+- `CheckoutCompletionError` - For validation or business logic failures
+- `ResponseArgsError` - For API failures
+
+**Example:**
+```typescript
+const orders = await facade.complete({
+  shoppingCartId: 123,
+  buyer: buyerDTO,
+  customerFeatures: { webshop: 'webshop', p4mUser: 'p4mUser' },
+  notificationChannels: 1,
+  payer: payerDTO,
+  shippingAddress: addressDTO
+}, abortController.signal);
+
+console.log(`Created ${orders.length} orders`);
+```
+
+#### `completeWithCrmData(params, abortSignal?): Promise<Order[]>`
+
+Completes checkout with CRM data, automatically transforming customer/payer/address.
+
+**Parameters:**
+- `params: CompleteCrmOrderParams`
+  - `shoppingCartId: number` - Shopping cart to process
+  - `crmCustomer: Customer` - Customer from CRM service
+  - `crmPayer?: PayerDTO` - Payer from CRM service (optional)
+  - `crmShippingAddress?: ShippingAddressDTO` - Shipping address from CRM (optional)
+  - `notificationChannels?: NotificationChannel` - Communication channels
+  - `specialComment?: string` - Special instructions
+- `abortSignal?: AbortSignal` - Optional cancellation signal
+
+**Returns:** Promise resolving to array of created orders
+
+**Throws:**
+- `CheckoutCompletionError` - For validation or business logic failures
+- `ResponseArgsError` - For API failures
+
+**Transformation Steps:**
+1. Validates input with Zod schema
+2. Converts `crmCustomer` to `buyer` using `CustomerAdapter.toBuyer()`
+3. Converts `crmShippingAddress` using `ShippingAddressAdapter.fromCrmShippingAddress()`
+4. Converts `crmPayer` using `PayerAdapter.toCheckoutFormat()`
+5. Extracts customer features using `CustomerAdapter.extractCustomerFeatures()`
+6. Delegates to `complete()` with transformed data
+
+**Example:**
+```typescript
+const customer = await customerResource.value();
+
+const orders = await facade.completeWithCrmData({
+  shoppingCartId: 123,
+  crmCustomer: customer,
+  crmShippingAddress: customer.shippingAddresses[0].data,
+  crmPayer: customer.payers[0].payer.data,
+  notificationChannels: customer.notificationChannels ?? 1,
+  specialComment: 'Rush delivery'
+});
+```
+
+### Helper Functions
+
+#### Analysis Helpers
+
+##### `analyzeOrderOptions(items): OrderOptionsAnalysis`
+
+Analyzes shopping cart items to determine which order types are present.
+
+**Parameters:**
+- `items: EntityContainer<ShoppingCartItem>[]` - Cart items to analyze
+
+**Returns:** Analysis result with boolean flags for each order type
+
+**Example:**
+```typescript
+const analysis = analyzeOrderOptions(cart.items);
+if (analysis.hasDelivery) {
+  console.log('Delivery items present - shipping address required');
+}
+```
+
+##### `analyzeCustomerTypes(features): CustomerTypeAnalysis`
+
+Analyzes customer features to determine customer type characteristics.
+
+**Parameters:**
+- `features: Record<string, string>` - Customer feature flags
+
+**Returns:** Analysis result with boolean flags for customer types
+
+##### `shouldSetPayer(options, customer): boolean`
+
+Determines if payer should be set based on order and customer analysis.
+
+**Business Rule:** Payer required when: `isB2B OR hasB2BDelivery OR hasDelivery OR hasDigDelivery OR hasDownload`
+
+##### `needsDestinationUpdate(options): boolean`
+
+Determines if destination update is needed.
+
+**Business Rule:** Update needed when: `hasDownload OR hasDelivery OR hasDigDelivery OR hasB2BDelivery`
+
+##### `determinePaymentType(options): PaymentType`
+
+Determines payment type based on order analysis.
+
+**Business Rules:**
+1. If all items have `loyalty.value > 0`: **FREE (2)**
+2. Else if has delivery/download orders: **INVOICE (128)**
+3. Else: **CASH (4)**
+
+### Adapters
+
+The library provides 8 specialized adapters for cross-domain data transformation:
+
+#### CustomerAdapter
+
+Converts CRM customer data to checkout-api format.
+
+**Static Methods:**
+- `toBuyer(customer): Buyer` - Converts customer to buyer
+- `toPayerFromCustomer(customer): Payer` - Converts customer to payer (self-paying)
+- `toPayerFromAssignedPayer(assignedPayer): Payer | null` - Unwraps AssignedPayer container
+- `extractCustomerFeatures(customer): Record<string, string>` - Extracts feature flags
+
+**Key Differences:**
+- **Buyer**: Includes `source` field and `dateOfBirth`
+- **Payer from Customer**: No `source`, no `dateOfBirth`, sets `payerStatus: 0`
+- **Payer from AssignedPayer**: Includes `source` field, unwraps EntityContainer
+
+## Usage Examples
+
+### Complete Multi-Step Checkout Workflow
+
+```typescript
+import { Component, inject, signal } from '@angular/core';
+import { ShoppingCartFacade, CheckoutCompletionError } from '@isa/checkout/data-access';
+import { CustomerResource } from '@isa/crm/data-access';
+
+@Component({
+  selector: 'app-checkout-flow',
+  template: `
+    <div class="checkout">
+      <h2>Checkout</h2>
+      @if (loading()) { <p>Processing checkout...</p> }
+      @if (error()) { <div class="error">{{ error() }}</div> }
+      <button (click)="processCheckout()" [disabled]="loading()">
+        Complete Checkout
+      </button>
+    </div>
+  `
+})
+export class CheckoutFlowComponent {
+  #shoppingCartFacade = inject(ShoppingCartFacade);
+  #customerResource = inject(CustomerResource);
+
+  loading = signal(false);
+  error = signal<string | null>(null);
+  orders = signal<Order[]>([]);
+
+  shoppingCartId = 123;
+
+  async processCheckout(): Promise<void> {
+    this.loading.set(true);
+    this.error.set(null);
+
+    try {
+      const customer = await this.#customerResource.value();
+      if (!customer) throw new Error('Customer not found');
+
+      const createdOrders = await this.#shoppingCartFacade.completeWithCrmData({
+        shoppingCartId: this.shoppingCartId,
+        crmCustomer: customer,
+        crmShippingAddress: customer.shippingAddresses?.[0]?.data,
+        crmPayer: customer.payers?.[0]?.payer?.data,
+        notificationChannels: customer.notificationChannels ?? 1
+      });
+
+      this.orders.set(createdOrders);
+    } catch (err) {
+      if (err instanceof CheckoutCompletionError) {
+        this.error.set(`Checkout failed: ${err.message}`);
+      } else {
+        this.error.set('An unexpected error occurred');
+      }
+    } finally {
+      this.loading.set(false);
+    }
+  }
+}
+```
+
+## Order Types
+
+### Parameter Requirements by Order Type
+
+| Order Type | Features Flag | Payment Type | Payer Required | Shipping Address | Special Handling |
+|------------|--------------|--------------|----------------|------------------|------------------|
+| **Rücklage** (InStore) | `orderType: 'Rücklage'` | CASH (4) | No | No | In-store reservation |
+| **Abholung** (Pickup) | `orderType: 'Abholung'` | CASH (4) | No | No | Customer pickup at branch |
+| **Versand** (Delivery) | `orderType: 'Versand'` | INVOICE (128) | Yes | Yes | Standard shipping |
+| **DIG-Versand** | `orderType: 'DIG-Versand'` | INVOICE (128) | Yes | Yes | Digital delivery, availability validation |
+| **B2B-Versand** | `orderType: 'B2B-Versand'` | INVOICE (128) | Yes | Yes | Logistician 2470, default branch |
+| **Download** | `orderType: 'Download'` | INVOICE (128) or FREE (2) | Yes | No | Download validation |
+
+## Checkout Flow
+
+The complete checkout process consists of 13 coordinated steps that validate data, transform cross-domain entities, update availabilities, and prepare the checkout for order creation.
+
+## Reward System
+
+### Dual Shopping Cart Architecture
+
+The reward system uses separate shopping carts:
+
+1. **Regular Shopping Cart** (`shoppingCartId`) - Items purchased with money
+2. **Reward Shopping Cart** (`rewardShoppingCartId`) - Items purchased with loyalty points (zero price, loyalty.value set)
+
+## Data Transformation
+
+### CRM to Checkout Transformation
+
+The library provides automatic transformation from CRM domain to checkout-api domain through specialized adapters.
+
+## Error Handling
+
+### CheckoutCompletionError Types
+
+```typescript
+type CheckoutCompletionErrorCode =
+  | 'SHOPPING_CART_NOT_FOUND'      // Cart with ID doesn't exist
+  | 'SHOPPING_CART_EMPTY'          // Cart has no items
+  | 'CHECKOUT_NOT_FOUND'           // Checkout entity not found
+  | 'INVALID_AVAILABILITY'         // Availability validation failed
+  | 'MISSING_BUYER'                // Buyer data not provided
+  | 'MISSING_REQUIRED_DATA'        // Required field missing
+  | 'CHECKOUT_CONFLICT'            // Order already exists (HTTP 409)
+  | 'ORDER_CREATION_FAILED'        // Order creation failed
+  | 'DOWNLOAD_UNAVAILABLE'         // Download items not available
+  | 'SHIPPING_AVAILABILITY_FAILED'; // Shipping availability update failed
+```
+
+## Testing
+
+The library uses **Vitest** with **Angular Testing Utilities** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test checkout-data-access --skip-nx-cache
+
+# Run tests with coverage
+npx nx test checkout-data-access --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test checkout-data-access --watch
+```
+
+## Architecture Notes
+
+### Current Architecture
+
+```
+Components/Features
+      ↓
+ShoppingCartFacade (orchestration)
+      ↓
+├─→ ShoppingCartService (cart CRUD)
+├─→ CheckoutService (checkout workflow)
+├─→ OrderCreationFacade (oms-api)
+└─→ Adapters (cross-domain transformation)
+
+Stores (NgRx Signals)
+      ↓
+RewardCatalogStore (reward state management)
+```
+
+### Key Design Decisions
+
+1. **Stateless Checkout Service** - All data passed as parameters for testability
+2. **Separation of Checkout and Order Creation** - Clean domain boundaries
+3. **Dual Shopping Cart for Rewards** - Payment and pricing isolation
+4. **Extensive Adapter Pattern** - 8 adapters for cross-domain transformation
+5. **Tab-Isolated Reward Catalog** - NgRx Signals with automatic cleanup
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework
+- `@ngrx/signals` - NgRx Signals for state management
+- `@generated/swagger/checkout-api` - Generated checkout API client
+- `@isa/common/data-access` - Common utilities
+- `@isa/core/logging` - Logging service
+- `@isa/core/storage` - Session storage
+- `@isa/core/tabs` - Tab service
+- `@isa/catalogue/data-access` - Availability services
+- `@isa/crm/data-access` - Customer types
+- `@isa/oms/data-access` - Order creation
+- `@isa/remission/data-access` - Branch service
+- `zod` - Schema validation
+- `rxjs` - Reactive programming
+
+### Path Alias
+
+Import from: `@isa/checkout/data-access`
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/checkout/data-access/src/lib/adapters/availability.adapter.ts b/libs/checkout/data-access/src/lib/adapters/availability.adapter.ts
index 623c9516a..7ab02c605 100644
--- a/libs/checkout/data-access/src/lib/adapters/availability.adapter.ts
+++ b/libs/checkout/data-access/src/lib/adapters/availability.adapter.ts
@@ -1,6 +1,6 @@
 import { PriceDTO, Price } from '@generated/swagger/checkout-api';
 import { Availability as AvaAvailability } from '@isa/availability/data-access';
-import { Availability, AvailabilityType } from '../models';
+import { Availability, AvailabilityType } from '../schemas';
 
 /**
  * Availability data from catalogue-api (raw response)
@@ -55,6 +55,8 @@ export class AvailabilityAdapter {
         data: {
           id: catalogueAvailability.supplier.id,
         },
+        // Explicitly omit externalReference to avoid TypeScript errors
+        // (generated DTOs require externalStatus when externalReference is present)
       },
       isPrebooked: catalogueAvailability.isPrebooked,
       estimatedShippingDate: catalogueAvailability.estimatedShippingDate,
@@ -78,6 +80,8 @@ export class AvailabilityAdapter {
         data: {
           id: catalogueAvailability.logistician.id,
         },
+        // Explicitly omit externalReference to avoid TypeScript errors
+        // (generated DTOs require externalStatus when externalReference is present)
       };
     }
 
@@ -132,6 +136,8 @@ export class AvailabilityAdapter {
         data: {
           id: availability.logisticianId,
         },
+        // Explicitly omit externalReference to avoid TypeScript errors
+        // (generated DTOs require externalStatus when externalReference is present)
       };
     }
 
@@ -142,6 +148,8 @@ export class AvailabilityAdapter {
         data: {
           id: availability.supplierId,
         },
+        // Explicitly omit externalReference to avoid TypeScript errors
+        // (generated DTOs require externalStatus when externalReference is present)
       };
     }
 
diff --git a/libs/checkout/data-access/src/lib/adapters/customer.adapter.ts b/libs/checkout/data-access/src/lib/adapters/customer.adapter.ts
index be4269c66..c82c9fd73 100644
--- a/libs/checkout/data-access/src/lib/adapters/customer.adapter.ts
+++ b/libs/checkout/data-access/src/lib/adapters/customer.adapter.ts
@@ -1,201 +1,219 @@
-import { Customer, AssignedPayer } from '@isa/crm/data-access';
-import { Buyer, Payer } from '../models';
-
-/**
- * Adapter for converting CRM customer data to checkout-api format.
- *
- * Handles three distinct conversion scenarios:
- * 1. **Customer to Buyer** (`toBuyer`): Converts customer for checkout as the buyer.
- * 2. **Customer to Payer** (`toPayerFromCustomer`): Uses customer as payer (self-paying).
- * 3. **AssignedPayer to Payer** (`toPayerFromAssignedPayer`): Unwraps separate payer entity.
- *
- * **Key Patterns:**
- * - Buyer conversion includes `dateOfBirth` and `source` field
- * - Payer from customer omits `source`, sets default `payerStatus: 0`
- * - AssignedPayer unwrapping handles `EntityContainer` structure with null safety
- */
-export class CustomerAdapter {
-  private static readonly ADAPTER_NAME = 'CustomerAdapter';
-
-  /**
-   * Converts Customer to checkout-api Buyer.
-   *
-   * @remarks
-   * Used when the customer is the buyer in a checkout flow. Maps all relevant
-   * customer information including personal details, address, and organization.
-   *
-   * The buyer includes a `source` field referencing the customer entity ID,
-   * and preserves the `dateOfBirth` field which is specific to buyers.
-   *
-   * Type mapping: `customerType` (CRM) → `buyerType` (Checkout)
-   *
-   * @param customer - Customer from CRM service
-   * @returns Buyer compatible with checkout-api
-   *
-   * @example
-   * ```typescript
-   * const customer = await crmService.getCustomer(123);
-   * const buyer = CustomerAdapter.toBuyer(customer);
-   * await checkoutService.complete({ buyer, ... });
-   * ```
-   */
-  static toBuyer(customer: Customer): Buyer {
-    return {
-      source: customer.id,
-      reference: { id: customer.id },
-      buyerType: customer.customerType,
-      buyerNumber: customer.customerNumber,
-      gender: customer.gender,
-      title: customer.title,
-      firstName: customer.firstName,
-      lastName: customer.lastName,
-      dateOfBirth: customer.dateOfBirth,
-      communicationDetails: customer.communicationDetails
-        ? { ...customer.communicationDetails }
-        : undefined,
-      organisation: customer.organisation
-        ? { ...customer.organisation }
-        : undefined,
-      address: customer.address ? { ...customer.address } : undefined,
-    };
-  }
-
-  /**
-   * Converts Customer to checkout-api Payer.
-   *
-   * @remarks
-   * Used when the customer acts as their own payer (self-paying scenarios,
-   * B2B customers, staff, customer card holders without separate billing address).
-   *
-   * **Important differences from toBuyer:**
-   * - No `source` field (indicates derived data, not a separate entity)
-   * - No `dateOfBirth` field (not relevant for payer)
-   * - Sets `payerStatus: 0` (active status by default)
-   *
-   * Type mapping: `customerType` (CRM) → `payerType` (Checkout)
-   *
-   * @param customer - Customer from CRM service
-   * @returns Payer compatible with checkout-api
-   *
-   * @example
-   * ```typescript
-   * const customer = await crmService.getCustomer(123);
-   * const payer = CustomerAdapter.toPayerFromCustomer(customer);
-   * await checkoutService.complete({ payer, ... });
-   * ```
-   */
-  static toPayerFromCustomer(customer: Customer): Payer {
-    return {
-      reference: { id: customer.id },
-      payerType: customer.customerType as Payer['payerType'],
-      payerNumber: customer.customerNumber,
-      payerStatus: 0, // Default status: active
-      gender: customer.gender,
-      title: customer.title,
-      firstName: customer.firstName,
-      lastName: customer.lastName,
-      communicationDetails: customer.communicationDetails
-        ? { ...customer.communicationDetails }
-        : undefined,
-      organisation: customer.organisation
-        ? { ...customer.organisation }
-        : undefined,
-      address: customer.address ? { ...customer.address } : undefined,
-    };
-  }
-
-  /**
-   * Converts AssignedPayer (EntityContainer wrapper) to checkout-api Payer.
-   *
-   * @remarks
-   * Used when customer has a separate billing address/payer entity assigned.
-   * Handles the CRM's `EntityContainer` structure which wraps payer data.
-   *
-   * **Container structure:**
-   * ```typescript
-   * assignedPayer: {
-   *   payer: {
-   *     id: number;
-   *     data?: PayerDTO;  // Actual payer data
-   *     displayName?: string;
-   *     enabled?: boolean;
-   *   }
-   * }
-   * ```
-   *
-   * Returns `null` if the payer data is missing or the container is invalid.
-   * Includes `source` field as this references a persistent payer entity.
-   *
-   * @param assignedPayer - AssignedPayer container from CRM service
-   * @returns Payer compatible with checkout-api, or null if data is missing
-   *
-   * @example
-   * ```typescript
-   * const assignedPayer = customer.payers.find(p => p.payer.id === selectedPayerId);
-   * const payer = CustomerAdapter.toPayerFromAssignedPayer(assignedPayer);
-   * if (payer) {
-   *   await checkoutService.complete({ payer, ... });
-   * }
-   * ```
-   */
-  static toPayerFromAssignedPayer(
-    assignedPayer: AssignedPayer,
-  ): Payer | null {
-    const payer = assignedPayer?.payer?.data;
-
-    if (!payer) {
-      return null;
-    }
-
-    return {
-      reference: { id: payer.id },
-      payerType: payer.payerType,
-      payerNumber: payer.payerNumber,
-      payerStatus: payer.payerStatus,
-      gender: payer.gender,
-      title: payer.title,
-      firstName: payer.firstName,
-      lastName: payer.lastName,
-      communicationDetails: payer.communicationDetails
-        ? { ...payer.communicationDetails }
-        : undefined,
-      organisation: payer.organisation ? { ...payer.organisation } : undefined,
-      address: payer.address ? { ...payer.address } : undefined,
-      source: payer.id,
-    };
-  }
-
-  /**
-   * Type guard for Customer
-   *
-   * @param value - Value to check
-   * @returns true if value is a valid Customer with required fields
-   */
-  static isValidCustomer(value: unknown): value is Customer {
-    if (typeof value !== 'object' || value === null) return false;
-
-    const customer = value as Customer;
-    return (
-      typeof customer.id === 'number' &&
-      (customer.customerNumber === undefined ||
-        typeof customer.customerNumber === 'string')
-    );
-  }
-
-  /**
-   * Type guard for AssignedPayer
-   *
-   * @param value - Value to check
-   * @returns true if value is a valid AssignedPayer with container structure
-   */
-  static isValidAssignedPayer(value: unknown): value is AssignedPayer {
-    if (typeof value !== 'object' || value === null) return false;
-
-    const assignedPayer = value as AssignedPayer;
-    return (
-      typeof assignedPayer.payer === 'object' &&
-      assignedPayer.payer !== null &&
-      typeof assignedPayer.payer.id === 'number'
-    );
-  }
-}
+import { Customer, AssignedPayer } from '@isa/crm/data-access';
+import { Buyer, Payer } from '../schemas';
+
+/**
+ * Adapter for converting CRM customer data to checkout-api format.
+ *
+ * Handles three distinct conversion scenarios:
+ * 1. **Customer to Buyer** (`toBuyer`): Converts customer for checkout as the buyer.
+ * 2. **Customer to Payer** (`toPayerFromCustomer`): Uses customer as payer (self-paying).
+ * 3. **AssignedPayer to Payer** (`toPayerFromAssignedPayer`): Unwraps separate payer entity.
+ *
+ * **Key Patterns:**
+ * - Buyer conversion includes `dateOfBirth` and `source` field
+ * - Payer from customer omits `source`, sets default `payerStatus: 0`
+ * - AssignedPayer unwrapping handles `EntityContainer` structure with null safety
+ */
+export class CustomerAdapter {
+  private static readonly ADAPTER_NAME = 'CustomerAdapter';
+
+  /**
+   * Converts Customer to checkout-api Buyer.
+   *
+   * @remarks
+   * Used when the customer is the buyer in a checkout flow. Maps all relevant
+   * customer information including personal details, address, and organization.
+   *
+   * The buyer includes a `source` field referencing the customer entity ID,
+   * and preserves the `dateOfBirth` field which is specific to buyers.
+   *
+   * Type mapping: `customerType` (CRM) → `buyerType` (Checkout)
+   *
+   * @param customer - Customer from CRM service
+   * @returns Buyer compatible with checkout-api
+   *
+   * @example
+   * ```typescript
+   * const customer = await crmService.getCustomer(123);
+   * const buyer = CustomerAdapter.toBuyer(customer);
+   * await checkoutService.complete({ buyer, ... });
+   * ```
+   */
+  static toBuyer(customer: Customer): Buyer {
+    return {
+      source: customer.id,
+      reference: {
+        id: customer.id,
+        // Explicitly omit externalReference to avoid TypeScript errors
+        // (generated DTOs require externalStatus when externalReference is present)
+      },
+      buyerType: customer.customerType,
+      buyerNumber: customer.customerNumber,
+      gender: customer.gender,
+      title: customer.title,
+      firstName: customer.firstName,
+      lastName: customer.lastName,
+      dateOfBirth: customer.dateOfBirth,
+      communicationDetails: customer.communicationDetails
+        ? { ...customer.communicationDetails }
+        : undefined,
+      organisation: customer.organisation
+        ? { ...customer.organisation }
+        : undefined,
+      address: customer.address ? { ...customer.address } : undefined,
+    };
+  }
+
+  /**
+   * Converts Customer to checkout-api Payer.
+   *
+   * @remarks
+   * Used when the customer acts as their own payer (self-paying scenarios,
+   * B2B customers, staff, customer card holders without separate billing address).
+   *
+   * **Important differences from toBuyer:**
+   * - No `source` field (indicates derived data, not a separate entity)
+   * - No `dateOfBirth` field (not relevant for payer)
+   * - Sets `payerStatus: 0` (active status by default)
+   *
+   * Type mapping: `customerType` (CRM) → `payerType` (Checkout)
+   *
+   * @param customer - Customer from CRM service
+   * @returns Payer compatible with checkout-api
+   *
+   * @example
+   * ```typescript
+   * const customer = await crmService.getCustomer(123);
+   * const payer = CustomerAdapter.toPayerFromCustomer(customer);
+   * await checkoutService.complete({ payer, ... });
+   * ```
+   */
+  static toPayerFromCustomer(customer: Customer): Payer {
+    return {
+      reference: {
+        id: customer.id,
+        // Explicitly omit externalReference to avoid TypeScript errors
+        // (generated DTOs require externalStatus when externalReference is present)
+      },
+      payerType: customer.customerType as Payer['payerType'],
+      payerNumber: customer.customerNumber,
+      payerStatus: 0, // Default status: active
+      gender: customer.gender,
+      title: customer.title,
+      firstName: customer.firstName,
+      lastName: customer.lastName,
+      communicationDetails: customer.communicationDetails
+        ? { ...customer.communicationDetails }
+        : undefined,
+      organisation: customer.organisation
+        ? { ...customer.organisation }
+        : undefined,
+      address: customer.address ? { ...customer.address } : undefined,
+    };
+  }
+
+  /**
+   * Converts AssignedPayer (EntityContainer wrapper) to checkout-api Payer.
+   *
+   * @remarks
+   * Used when customer has a separate billing address/payer entity assigned.
+   * Handles the CRM's `EntityContainer` structure which wraps payer data.
+   *
+   * **Container structure:**
+   * ```typescript
+   * assignedPayer: {
+   *   payer: {
+   *     id: number;
+   *     data?: PayerDTO;  // Actual payer data
+   *     displayName?: string;
+   *     enabled?: boolean;
+   *   }
+   * }
+   * ```
+   *
+   * Returns `null` if the payer data is missing or the container is invalid.
+   * Includes `source` field as this references a persistent payer entity.
+   *
+   * @param assignedPayer - AssignedPayer container from CRM service
+   * @returns Payer compatible with checkout-api, or null if data is missing
+   *
+   * @example
+   * ```typescript
+   * const assignedPayer = customer.payers.find(p => p.payer.id === selectedPayerId);
+   * const payer = CustomerAdapter.toPayerFromAssignedPayer(assignedPayer);
+   * if (payer) {
+   *   await checkoutService.complete({ payer, ... });
+   * }
+   * ```
+   */
+  static toPayerFromAssignedPayer(assignedPayer: AssignedPayer): Payer | null {
+    const payer = assignedPayer?.payer?.data;
+
+    if (!payer) {
+      return null;
+    }
+
+    return {
+      reference: {
+        id: payer.id,
+        // Explicitly omit externalReference to avoid TypeScript errors
+        // (generated DTOs require externalStatus when externalReference is present)
+      },
+      payerType: payer.payerType,
+      payerNumber: payer.payerNumber,
+      payerStatus: payer.payerStatus,
+      gender: payer.gender,
+      title: payer.title,
+      firstName: payer.firstName,
+      lastName: payer.lastName,
+      communicationDetails: payer.communicationDetails
+        ? { ...payer.communicationDetails }
+        : undefined,
+      organisation: payer.organisation ? { ...payer.organisation } : undefined,
+      address: payer.address ? { ...payer.address } : undefined,
+      source: payer.id,
+    };
+  }
+
+  /**
+   * Type guard for Customer
+   *
+   * @param value - Value to check
+   * @returns true if value is a valid Customer with required fields
+   */
+  static isValidCustomer(value: unknown): value is Customer {
+    if (typeof value !== 'object' || value === null) return false;
+
+    const customer = value as Customer;
+    return (
+      typeof customer.id === 'number' &&
+      (customer.customerNumber === undefined ||
+        typeof customer.customerNumber === 'string')
+    );
+  }
+
+  /**
+   * Type guard for AssignedPayer
+   *
+   * @param value - Value to check
+   * @returns true if value is a valid AssignedPayer with container structure
+   */
+  static isValidAssignedPayer(value: unknown): value is AssignedPayer {
+    if (typeof value !== 'object' || value === null) return false;
+
+    const assignedPayer = value as AssignedPayer;
+    return (
+      typeof assignedPayer.payer === 'object' &&
+      assignedPayer.payer !== null &&
+      typeof assignedPayer.payer.id === 'number'
+    );
+  }
+
+  static extractCustomerFeatures(customer: Customer): Record<string, any> {
+    const features = customer.features || [];
+    return features.reduce((acc: Record<string, string>, feature: any) => {
+      acc[feature.key] = feature.key;
+      return acc;
+    }, {});
+  }
+}
diff --git a/libs/checkout/data-access/src/lib/adapters/payer.adapter.ts b/libs/checkout/data-access/src/lib/adapters/payer.adapter.ts
index ee2073131..5a146411c 100644
--- a/libs/checkout/data-access/src/lib/adapters/payer.adapter.ts
+++ b/libs/checkout/data-access/src/lib/adapters/payer.adapter.ts
@@ -1,73 +1,72 @@
-import { Payer as CrmPayer } from '@isa/crm/data-access';
-import { Payer } from '../models';
-
-/**
- * Adapter for converting CRM-api payer responses to checkout-api format.
- *
- * Handles:
- * - Filtering CRM-specific fields (agentComment, deactivationComment, etc.)
- * - Entity reference creation (reference.id, source)
- * - Nested object copying (communicationDetails, organisation, address)
- */
-export class PayerAdapter {
-  private static readonly ADAPTER_NAME = 'PayerAdapter';
-
-  /**
-   * Converts CRM-api payer to checkout-api Payer.
-   *
-   * @remarks
-   * Maps payer information from the CRM domain to the checkout domain's
-   * payer representation. CRM-specific fields like agentComment, deactivationComment,
-   * defaultPaymentPeriod, isGuestAccount, payerGroup, paymentTypes,
-   * standardInvoiceText, statusChangeComment, and statusComment are filtered out.
-   *
-   * Nested objects (communicationDetails, organisation, address) are shallow-copied
-   * to prevent unintended mutations.
-   *
-   * @param crmPayer - Raw payer from CRM service
-   * @returns Payer compatible with checkout-api
-   *
-   * @example
-   * ```typescript
-   * const checkoutPayer = PayerAdapter.toCheckoutFormat(crmPayer);
-   * await checkoutService.complete({ payer: checkoutPayer, ... });
-   * ```
-   */
-  static toCheckoutFormat(crmPayer: CrmPayer): Payer {
-    return {
-      reference: { id: crmPayer.id },
-      source: crmPayer.id,
-      payerType: crmPayer.payerType,
-      payerNumber: crmPayer.payerNumber,
-      payerStatus: crmPayer.payerStatus,
-      gender: crmPayer.gender,
-      title: crmPayer.title,
-      firstName: crmPayer.firstName,
-      lastName: crmPayer.lastName,
-      communicationDetails: crmPayer.communicationDetails
-        ? { ...crmPayer.communicationDetails }
-        : undefined,
-      organisation: crmPayer.organisation
-        ? { ...crmPayer.organisation }
-        : undefined,
-      address: crmPayer.address ? { ...crmPayer.address } : undefined,
-    };
-  }
-
-  /**
-   * Type guard for CRM payer response
-   *
-   * @param value - Value to check
-   * @returns true if value is a valid CRM payer with required fields
-   */
-  static isValidCrmPayer(value: unknown): value is CrmPayer {
-    if (typeof value !== 'object' || value === null) return false;
-
-    const payer = value as CrmPayer;
-    return (
-      typeof payer.id === 'number' &&
-      (payer.payerNumber === undefined ||
-        typeof payer.payerNumber === 'string')
-    );
-  }
-}
+import { Payer as CrmPayer } from '@isa/crm/data-access';
+import { Payer } from '../schemas';
+
+/**
+ * Adapter for converting CRM-api payer responses to checkout-api format.
+ *
+ * Handles:
+ * - Filtering CRM-specific fields (agentComment, deactivationComment, etc.)
+ * - Entity reference creation (reference.id, source)
+ * - Nested object copying (communicationDetails, organisation, address)
+ */
+export class PayerAdapter {
+  private static readonly ADAPTER_NAME = 'PayerAdapter';
+
+  /**
+   * Converts CRM-api payer to checkout-api Payer.
+   *
+   * @remarks
+   * Maps payer information from the CRM domain to the checkout domain's
+   * payer representation. CRM-specific fields like agentComment, deactivationComment,
+   * defaultPaymentPeriod, isGuestAccount, payerGroup, paymentTypes,
+   * standardInvoiceText, statusChangeComment, and statusComment are filtered out.
+   *
+   * Nested objects (communicationDetails, organisation, address) are shallow-copied
+   * to prevent unintended mutations.
+   *
+   * @param crmPayer - Raw payer from CRM service
+   * @returns Payer compatible with checkout-api
+   *
+   * @example
+   * ```typescript
+   * const checkoutPayer = PayerAdapter.toCheckoutFormat(crmPayer);
+   * await checkoutService.complete({ payer: checkoutPayer, ... });
+   * ```
+   */
+  static toCheckoutFormat(crmPayer: CrmPayer): Payer {
+    return {
+      reference: { id: crmPayer.id },
+      source: crmPayer.id,
+      payerType: crmPayer.payerType,
+      payerNumber: crmPayer.payerNumber,
+      payerStatus: crmPayer.payerStatus,
+      gender: crmPayer.gender,
+      title: crmPayer.title,
+      firstName: crmPayer.firstName,
+      lastName: crmPayer.lastName,
+      communicationDetails: crmPayer.communicationDetails
+        ? { ...crmPayer.communicationDetails }
+        : undefined,
+      organisation: crmPayer.organisation
+        ? { ...crmPayer.organisation }
+        : undefined,
+      address: crmPayer.address ? { ...crmPayer.address } : undefined,
+    };
+  }
+
+  /**
+   * Type guard for CRM payer response
+   *
+   * @param value - Value to check
+   * @returns true if value is a valid CRM payer with required fields
+   */
+  static isValidCrmPayer(value: unknown): value is CrmPayer {
+    if (typeof value !== 'object' || value === null) return false;
+
+    const payer = value as CrmPayer;
+    return (
+      typeof payer.id === 'number' &&
+      (payer.payerNumber === undefined || typeof payer.payerNumber === 'string')
+    );
+  }
+}
diff --git a/libs/checkout/data-access/src/lib/adapters/shipping-address.adapter.ts b/libs/checkout/data-access/src/lib/adapters/shipping-address.adapter.ts
index cea716a9f..aa79fc6f1 100644
--- a/libs/checkout/data-access/src/lib/adapters/shipping-address.adapter.ts
+++ b/libs/checkout/data-access/src/lib/adapters/shipping-address.adapter.ts
@@ -1,136 +1,136 @@
-import { Customer } from '@isa/crm/data-access';
-import { ShippingAddressDTO as CrmShippingAddressDTO } from '@generated/swagger/crm-api';
-import { ShippingAddressDTO as CheckoutShippingAddressDTO } from '@generated/swagger/checkout-api';
-
-/**
- * Adapter for converting CRM shipping address data to checkout-api format.
- *
- * Handles two distinct conversion scenarios:
- * 1. **Separate Shipping Address Entity** (`fromCrmShippingAddress`): Converts a dedicated
- *    shipping address from CRM with `source` field, indicating a persistent entity.
- * 2. **Customer Primary Address** (`fromCustomer`): Derives shipping address from customer's
- *    primary address without `source` field, indicating transient/derived data.
- *
- * **Key Differences:**
- * - CRM ShippingAddressDTO: Filters out CRM-specific fields (type, validated, agentComment, etc.)
- * - Customer Address: Uses customer ID for reference, omits `source` field
- */
-export class ShippingAddressAdapter {
-  private static readonly ADAPTER_NAME = 'ShippingAddressAdapter';
-
-  /**
-   * Converts CRM-api ShippingAddressDTO to checkout-api format.
-   *
-   * @remarks
-   * Used when customer has separate delivery addresses stored in `customer.shippingAddresses[]`.
-   * The resulting address includes a `source` field, indicating it references a persistent
-   * shipping address entity in the CRM system.
-   *
-   * Filters out CRM-specific fields:
-   * - `type` (ShippingAddressType)
-   * - `validated` (validation flag)
-   * - `validationResult` (validation status code)
-   * - `agentComment` (internal notes)
-   * - `isDefault` (default address flag)
-   *
-   * @param address - Raw shipping address from CRM service
-   * @returns ShippingAddressDTO compatible with checkout-api, includes `source` field
-   *
-   * @example
-   * ```typescript
-   * const crmAddress = customer.shippingAddresses[0].data;
-   * const checkoutAddress = ShippingAddressAdapter.fromCrmShippingAddress(crmAddress);
-   * await checkoutService.complete({ shippingAddress: checkoutAddress, ... });
-   * ```
-   */
-  static fromCrmShippingAddress(
-    address: CrmShippingAddressDTO,
-  ): CheckoutShippingAddressDTO {
-    return {
-      reference: { id: address.id },
-      gender: address.gender,
-      title: address.title,
-      firstName: address.firstName,
-      lastName: address.lastName,
-      communicationDetails: address.communicationDetails
-        ? { ...address.communicationDetails }
-        : undefined,
-      organisation: address.organisation
-        ? { ...address.organisation }
-        : undefined,
-      address: address.address ? { ...address.address } : undefined,
-      source: address.id,
-    };
-  }
-
-  /**
-   * Converts Customer to checkout-api ShippingAddressDTO.
-   *
-   * @remarks
-   * Used when customer's primary address is used for shipping (e.g., B2B customers, staff,
-   * customer card holders without separate delivery addresses).
-   *
-   * The resulting address **does not include** a `source` field, indicating this is derived
-   * from the customer entity and not a separate persistent shipping address entity.
-   *
-   * Uses customer's primary address data (`customer.address`) and personal information.
-   *
-   * @param customer - Customer from CRM service
-   * @returns ShippingAddressDTO compatible with checkout-api, omits `source` field
-   *
-   * @example
-   * ```typescript
-   * const customer = await crmService.getCustomer(123);
-   * const checkoutAddress = ShippingAddressAdapter.fromCustomer(customer);
-   * await checkoutService.complete({ shippingAddress: checkoutAddress, ... });
-   * ```
-   */
-  static fromCustomer(customer: Customer): CheckoutShippingAddressDTO {
-    return {
-      reference: { id: customer.id },
-      gender: customer.gender,
-      title: customer.title,
-      firstName: customer.firstName,
-      lastName: customer.lastName,
-      communicationDetails: customer.communicationDetails
-        ? { ...customer.communicationDetails }
-        : undefined,
-      organisation: customer.organisation
-        ? { ...customer.organisation }
-        : undefined,
-      address: customer.address ? { ...customer.address } : undefined,
-    };
-  }
-
-  /**
-   * Type guard for CRM shipping address response
-   *
-   * @param value - Value to check
-   * @returns true if value is a valid CRM shipping address with required fields
-   */
-  static isValidCrmShippingAddress(
-    value: unknown,
-  ): value is CrmShippingAddressDTO {
-    if (typeof value !== 'object' || value === null) return false;
-
-    const address = value as CrmShippingAddressDTO;
-    return typeof address.id === 'number';
-  }
-
-  /**
-   * Type guard for Customer
-   *
-   * @param value - Value to check
-   * @returns true if value is a valid Customer with required fields
-   */
-  static isValidCustomer(value: unknown): value is Customer {
-    if (typeof value !== 'object' || value === null) return false;
-
-    const customer = value as Customer;
-    return (
-      typeof customer.id === 'number' &&
-      (customer.customerNumber === undefined ||
-        typeof customer.customerNumber === 'string')
-    );
-  }
-}
+import { Customer } from '@isa/crm/data-access';
+import { ShippingAddress as CrmShippingAddress } from '@isa/crm/data-access';
+import { ShippingAddress as CheckoutShippingAddress } from '@isa/checkout/data-access';
+
+/**
+ * Adapter for converting CRM shipping address data to checkout-api format.
+ *
+ * Handles two distinct conversion scenarios:
+ * 1. **Separate Shipping Address Entity** (`fromCrmShippingAddress`): Converts a dedicated
+ *    shipping address from CRM with `source` field, indicating a persistent entity.
+ * 2. **Customer Primary Address** (`fromCustomer`): Derives shipping address from customer's
+ *    primary address without `source` field, indicating transient/derived data.
+ *
+ * **Key Differences:**
+ * - CRM ShippingAddressDTO: Filters out CRM-specific fields (type, validated, agentComment, etc.)
+ * - Customer Address: Uses customer ID for reference, omits `source` field
+ */
+export class ShippingAddressAdapter {
+  private static readonly ADAPTER_NAME = 'ShippingAddressAdapter';
+
+  /**
+   * Converts CRM-api ShippingAddressDTO to checkout-api format.
+   *
+   * @remarks
+   * Used when customer has separate delivery addresses stored in `customer.shippingAddresses[]`.
+   * The resulting address includes a `source` field, indicating it references a persistent
+   * shipping address entity in the CRM system.
+   *
+   * Filters out CRM-specific fields:
+   * - `type` (ShippingAddressType)
+   * - `validated` (validation flag)
+   * - `validationResult` (validation status code)
+   * - `agentComment` (internal notes)
+   * - `isDefault` (default address flag)
+   *
+   * @param address - Raw shipping address from CRM service
+   * @returns ShippingAddressDTO compatible with checkout-api, includes `source` field
+   *
+   * @example
+   * ```typescript
+   * const crmAddress = customer.shippingAddresses[0].data;
+   * const checkoutAddress = ShippingAddressAdapter.fromCrmShippingAddress(crmAddress);
+   * await checkoutService.complete({ shippingAddress: checkoutAddress, ... });
+   * ```
+   */
+  static fromCrmShippingAddress(
+    address: CrmShippingAddress,
+  ): CheckoutShippingAddress {
+    return {
+      reference: { id: address.id },
+      gender: address.gender,
+      title: address.title,
+      firstName: address.firstName,
+      lastName: address.lastName,
+      communicationDetails: address.communicationDetails
+        ? { ...address.communicationDetails }
+        : undefined,
+      organisation: address.organisation
+        ? { ...address.organisation }
+        : undefined,
+      address: address.address ? { ...address.address } : undefined,
+      source: address.id,
+    };
+  }
+
+  /**
+   * Converts Customer to checkout-api ShippingAddressDTO.
+   *
+   * @remarks
+   * Used when customer's primary address is used for shipping (e.g., B2B customers, staff,
+   * customer card holders without separate delivery addresses).
+   *
+   * The resulting address **does not include** a `source` field, indicating this is derived
+   * from the customer entity and not a separate persistent shipping address entity.
+   *
+   * Uses customer's primary address data (`customer.address`) and personal information.
+   *
+   * @param customer - Customer from CRM service
+   * @returns ShippingAddressDTO compatible with checkout-api, omits `source` field
+   *
+   * @example
+   * ```typescript
+   * const customer = await crmService.getCustomer(123);
+   * const checkoutAddress = ShippingAddressAdapter.fromCustomer(customer);
+   * await checkoutService.complete({ shippingAddress: checkoutAddress, ... });
+   * ```
+   */
+  static fromCustomer(customer: Customer): CheckoutShippingAddress {
+    return {
+      reference: { id: customer.id },
+      gender: customer.gender,
+      title: customer.title,
+      firstName: customer.firstName,
+      lastName: customer.lastName,
+      communicationDetails: customer.communicationDetails
+        ? { ...customer.communicationDetails }
+        : undefined,
+      organisation: customer.organisation
+        ? { ...customer.organisation }
+        : undefined,
+      address: customer.address ? { ...customer.address } : undefined,
+    };
+  }
+
+  /**
+   * Type guard for CRM shipping address response
+   *
+   * @param value - Value to check
+   * @returns true if value is a valid CRM shipping address with required fields
+   */
+  static isValidCrmShippingAddress(
+    value: unknown,
+  ): value is CrmShippingAddress {
+    if (typeof value !== 'object' || value === null) return false;
+
+    const address = value as CrmShippingAddress;
+    return typeof address.id === 'number';
+  }
+
+  /**
+   * Type guard for Customer
+   *
+   * @param value - Value to check
+   * @returns true if value is a valid Customer with required fields
+   */
+  static isValidCustomer(value: unknown): value is Customer {
+    if (typeof value !== 'object' || value === null) return false;
+
+    const customer = value as Customer;
+    return (
+      typeof customer.id === 'number' &&
+      (customer.customerNumber === undefined ||
+        typeof customer.customerNumber === 'string')
+    );
+  }
+}
diff --git a/libs/checkout/data-access/src/lib/facades/shopping-cart.facade.spec.ts b/libs/checkout/data-access/src/lib/facades/shopping-cart.facade.spec.ts
new file mode 100644
index 000000000..6378c44e5
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/facades/shopping-cart.facade.spec.ts
@@ -0,0 +1,650 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { TestBed } from '@angular/core/testing';
+import { ZodError } from 'zod';
+import { ShoppingCartFacade } from './shopping-cart.facade';
+import { CheckoutService, ShoppingCartService } from '../services';
+import { Customer, Payer as CrmPayer } from '@isa/crm/data-access';
+import { ShippingAddressDTO as CrmShippingAddressDTO } from '@generated/swagger/crm-api';
+import { Order } from '../models';
+
+describe('ShoppingCartFacade', () => {
+  let facade: ShoppingCartFacade;
+  let mockCheckoutService: {
+    complete: ReturnType<typeof vi.fn>;
+  };
+  let mockShoppingCartService: {
+    createShoppingCart: ReturnType<typeof vi.fn>;
+    getShoppingCart: ReturnType<typeof vi.fn>;
+    removeItem: ReturnType<typeof vi.fn>;
+    updateItem: ReturnType<typeof vi.fn>;
+  };
+
+  beforeEach(() => {
+    mockCheckoutService = {
+      complete: vi.fn(),
+    };
+
+    mockShoppingCartService = {
+      createShoppingCart: vi.fn(),
+      getShoppingCart: vi.fn(),
+      removeItem: vi.fn(),
+      updateItem: vi.fn(),
+    };
+
+    TestBed.configureTestingModule({
+      providers: [
+        ShoppingCartFacade,
+        { provide: CheckoutService, useValue: mockCheckoutService },
+        { provide: ShoppingCartService, useValue: mockShoppingCartService },
+      ],
+    });
+
+    facade = TestBed.inject(ShoppingCartFacade);
+  });
+
+  describe('completeWithCrmData', () => {
+    it('should transform CRM data and complete order successfully', async () => {
+      // Arrange
+      const mockOrders: Order[] = [
+        { id: 1, orderNumber: 'ORDER-001' } as Order,
+      ];
+
+      mockCheckoutService.complete.mockResolvedValue(mockOrders);
+
+      const customer: Customer = {
+        id: 123,
+        customerNumber: 'CUST-123',
+        customerType: 8, // B2C
+        firstName: 'John',
+        lastName: 'Doe',
+        notificationChannels: 1,
+        features: [
+          { key: 'FEATURE1', value: 'value1' },
+          { key: 'FEATURE2', value: 'value2' },
+        ],
+      } as Customer;
+
+      // Act
+      const result = await facade.completeWithCrmData({
+        shoppingCartId: 456,
+        customer,
+      });
+
+      // Assert
+      expect(result).toEqual(mockOrders);
+      expect(mockCheckoutService.complete).toHaveBeenCalledOnce();
+      expect(mockCheckoutService.complete).toHaveBeenCalledWith(
+        expect.objectContaining({
+          shoppingCartId: 456,
+          buyer: expect.objectContaining({
+            reference: { id: 123 },
+            source: 123,
+            buyerType: 8,
+            buyerNumber: 'CUST-123',
+            firstName: 'John',
+            lastName: 'Doe',
+          }),
+          notificationChannels: 1,
+          customerFeatures: { FEATURE1: 'FEATURE1', FEATURE2: 'FEATURE2' },
+        }),
+        undefined,
+      );
+    });
+
+    it('should transform CRM shipping address when provided', async () => {
+      // Arrange
+      const mockOrders: Order[] = [
+        { id: 1, orderNumber: 'ORDER-001' } as Order,
+      ];
+
+      mockCheckoutService.complete.mockResolvedValue(mockOrders);
+
+      const customer: Customer = {
+        id: 123,
+        customerNumber: 'CUST-123',
+        customerType: 8,
+        firstName: 'John',
+        lastName: 'Doe',
+        notificationChannels: 1,
+        features: [],
+      } as Customer;
+
+      const crmShippingAddress: CrmShippingAddressDTO = {
+        id: 789,
+        firstName: 'Jane',
+        lastName: 'Doe',
+        address: {
+          street: 'Main St',
+          streetNumber: '123',
+          zipCode: '12345',
+          city: 'Berlin',
+          country: 'DE',
+        },
+      };
+
+      // Act
+      await facade.completeWithCrmData({
+        shoppingCartId: 456,
+        customer,
+        crmShippingAddress,
+      });
+
+      // Assert
+      expect(mockCheckoutService.complete).toHaveBeenCalledWith(
+        expect.objectContaining({
+          shippingAddress: expect.objectContaining({
+            reference: { id: 789 },
+            source: 789,
+            firstName: 'Jane',
+            lastName: 'Doe',
+            address: expect.objectContaining({
+              street: 'Main St',
+              streetNumber: '123',
+              zipCode: '12345',
+              city: 'Berlin',
+              country: 'DE',
+            }),
+          }),
+        }),
+        undefined,
+      );
+    });
+
+    it('should transform CRM payer when provided', async () => {
+      // Arrange
+      const mockOrders: Order[] = [
+        { id: 1, orderNumber: 'ORDER-001' } as Order,
+      ];
+
+      mockCheckoutService.complete.mockResolvedValue(mockOrders);
+
+      const customer: Customer = {
+        id: 123,
+        customerNumber: 'CUST-123',
+        customerType: 8,
+        firstName: 'John',
+        lastName: 'Doe',
+        notificationChannels: 1,
+        features: [],
+      } as Customer;
+
+      const crmPayer: CrmPayer = {
+        id: 999,
+        payerNumber: 'PAY-999',
+        payerType: 16, // B2B
+        payerStatus: 0,
+        firstName: 'Billing',
+        lastName: 'Company',
+      } as CrmPayer;
+
+      // Act
+      await facade.completeWithCrmData({
+        shoppingCartId: 456,
+        customer,
+        crmPayer,
+      });
+
+      // Assert
+      expect(mockCheckoutService.complete).toHaveBeenCalledWith(
+        expect.objectContaining({
+          payer: expect.objectContaining({
+            reference: { id: 999 },
+            source: 999,
+            payerType: 16,
+            payerNumber: 'PAY-999',
+            payerStatus: 0,
+            firstName: 'Billing',
+            lastName: 'Company',
+          }),
+        }),
+        undefined,
+      );
+    });
+
+    it('should use provided notificationChannels over customer default', async () => {
+      // Arrange
+      mockCheckoutService.complete.mockResolvedValue([]);
+
+      const customer: Customer = {
+        id: 123,
+        customerNumber: 'CUST-123',
+        customerType: 8,
+        firstName: 'John',
+        lastName: 'Doe',
+        notificationChannels: 1, // Customer default
+        features: [],
+      } as Customer;
+
+      // Act
+      await facade.completeWithCrmData({
+        shoppingCartId: 456,
+        customer,
+        notificationChannels: 4, // Override
+      });
+
+      // Assert
+      expect(mockCheckoutService.complete).toHaveBeenCalledWith(
+        expect.objectContaining({
+          notificationChannels: 4, // Should use override
+        }),
+        undefined,
+      );
+    });
+
+    it('should use customer notificationChannels when not provided', async () => {
+      // Arrange
+      mockCheckoutService.complete.mockResolvedValue([]);
+
+      const customer: Customer = {
+        id: 123,
+        customerNumber: 'CUST-123',
+        customerType: 8,
+        firstName: 'John',
+        lastName: 'Doe',
+        notificationChannels: 2, // Customer default
+        features: [],
+      } as Customer;
+
+      // Act
+      await facade.completeWithCrmData({
+        shoppingCartId: 456,
+        customer,
+      });
+
+      // Assert
+      expect(mockCheckoutService.complete).toHaveBeenCalledWith(
+        expect.objectContaining({
+          notificationChannels: 2, // Should use customer default
+        }),
+        undefined,
+      );
+    });
+
+    it('should default to 1 when customer notificationChannels is undefined', async () => {
+      // Arrange
+      mockCheckoutService.complete.mockResolvedValue([]);
+
+      const customer: Customer = {
+        id: 123,
+        customerNumber: 'CUST-123',
+        customerType: 8,
+        firstName: 'John',
+        lastName: 'Doe',
+        notificationChannels: undefined, // Not set
+        features: [],
+      } as Customer;
+
+      // Act
+      await facade.completeWithCrmData({
+        shoppingCartId: 456,
+        customer,
+      });
+
+      // Assert
+      expect(mockCheckoutService.complete).toHaveBeenCalledWith(
+        expect.objectContaining({
+          notificationChannels: 1, // Should default to 1
+        }),
+        undefined,
+      );
+    });
+
+    it('should handle missing optional shipping address', async () => {
+      // Arrange
+      mockCheckoutService.complete.mockResolvedValue([]);
+
+      const customer: Customer = {
+        id: 123,
+        customerNumber: 'CUST-123',
+        customerType: 8,
+        firstName: 'John',
+        lastName: 'Doe',
+        notificationChannels: 1,
+        features: [],
+      } as Customer;
+
+      // Act
+      await facade.completeWithCrmData({
+        shoppingCartId: 456,
+        customer,
+        crmShippingAddress: undefined,
+      });
+
+      // Assert
+      expect(mockCheckoutService.complete).toHaveBeenCalledWith(
+        expect.objectContaining({
+          shippingAddress: undefined,
+        }),
+        undefined,
+      );
+    });
+
+    it('should handle missing optional payer', async () => {
+      // Arrange
+      mockCheckoutService.complete.mockResolvedValue([]);
+
+      const customer: Customer = {
+        id: 123,
+        customerNumber: 'CUST-123',
+        customerType: 8,
+        firstName: 'John',
+        lastName: 'Doe',
+        notificationChannels: 1,
+        features: [],
+      } as Customer;
+
+      // Act
+      await facade.completeWithCrmData({
+        shoppingCartId: 456,
+        customer,
+        crmPayer: undefined,
+      });
+
+      // Assert
+      expect(mockCheckoutService.complete).toHaveBeenCalledWith(
+        expect.objectContaining({
+          payer: undefined,
+        }),
+        undefined,
+      );
+    });
+
+    it('should pass abort signal to underlying service', async () => {
+      // Arrange
+      mockCheckoutService.complete.mockResolvedValue([]);
+
+      const customer: Customer = {
+        id: 123,
+        customerNumber: 'CUST-123',
+        customerType: 8,
+        firstName: 'John',
+        lastName: 'Doe',
+        notificationChannels: 1,
+        features: [],
+      } as Customer;
+
+      const abortController = new AbortController();
+
+      // Act
+      await facade.completeWithCrmData(
+        {
+          shoppingCartId: 456,
+          customer,
+        },
+        abortController.signal,
+      );
+
+      // Assert
+      expect(mockCheckoutService.complete).toHaveBeenCalledWith(
+        expect.any(Object),
+        abortController.signal,
+      );
+    });
+
+    it('should extract customer features correctly', async () => {
+      // Arrange
+      mockCheckoutService.complete.mockResolvedValue([]);
+
+      const customer: Customer = {
+        id: 123,
+        customerNumber: 'CUST-123',
+        customerType: 8,
+        firstName: 'John',
+        lastName: 'Doe',
+        notificationChannels: 1,
+        features: [
+          { key: 'FEATURE_A', value: 'some value' },
+          { key: 'FEATURE_B', value: 'another value' },
+          { key: 'FEATURE_C', value: 'third value' },
+        ],
+      } as Customer;
+
+      // Act
+      await facade.completeWithCrmData({
+        shoppingCartId: 456,
+        customer,
+      });
+
+      // Assert
+      expect(mockCheckoutService.complete).toHaveBeenCalledWith(
+        expect.objectContaining({
+          customerFeatures: {
+            FEATURE_A: 'FEATURE_A',
+            FEATURE_B: 'FEATURE_B',
+            FEATURE_C: 'FEATURE_C',
+          },
+        }),
+        undefined,
+      );
+    });
+
+    it('should handle empty customer features', async () => {
+      // Arrange
+      mockCheckoutService.complete.mockResolvedValue([]);
+
+      const customer: Customer = {
+        id: 123,
+        customerNumber: 'CUST-123',
+        customerType: 8,
+        firstName: 'John',
+        lastName: 'Doe',
+        notificationChannels: 1,
+        features: [],
+      } as Customer;
+
+      // Act
+      await facade.completeWithCrmData({
+        shoppingCartId: 456,
+        customer,
+      });
+
+      // Assert
+      expect(mockCheckoutService.complete).toHaveBeenCalledWith(
+        expect.objectContaining({
+          customerFeatures: {},
+        }),
+        undefined,
+      );
+    });
+
+    it('should throw error for invalid shopping cart ID', async () => {
+      // Arrange
+      const customer: Customer = {
+        id: 123,
+        customerNumber: 'CUST-123',
+        customerType: 8,
+        firstName: 'John',
+        lastName: 'Doe',
+        notificationChannels: 1,
+        features: [],
+      } as Customer;
+
+      // Act & Assert
+      try {
+        await facade.completeWithCrmData({
+          shoppingCartId: -1, // Invalid ID
+          customer,
+        });
+        expect.fail('Should have thrown ZodError');
+      } catch (error) {
+        expect(error).toBeInstanceOf(ZodError);
+      }
+    });
+
+    it('should throw error for invalid customer data', async () => {
+      // Act & Assert
+      try {
+        await facade.completeWithCrmData({
+          shoppingCartId: 456,
+          customer: { invalid: 'data' } as any, // Invalid customer
+        });
+        expect.fail('Should have thrown ZodError');
+      } catch (error) {
+        expect(error).toBeInstanceOf(ZodError);
+      }
+    });
+
+    it('should propagate errors from checkout service', async () => {
+      // Arrange
+      const checkoutError = new Error('Checkout failed');
+      mockCheckoutService.complete.mockRejectedValue(checkoutError);
+
+      const customer: Customer = {
+        id: 123,
+        customerNumber: 'CUST-123',
+        customerType: 8,
+        firstName: 'John',
+        lastName: 'Doe',
+        notificationChannels: 1,
+        features: [],
+      } as Customer;
+
+      // Act & Assert
+      await expect(
+        facade.completeWithCrmData({
+          shoppingCartId: 456,
+          customer,
+        }),
+      ).rejects.toThrow('Checkout failed');
+    });
+
+    it('should handle all parameters together', async () => {
+      // Arrange
+      const mockOrders: Order[] = [
+        { id: 1, orderNumber: 'ORDER-001' } as Order,
+        { id: 2, orderNumber: 'ORDER-002' } as Order,
+      ];
+
+      mockCheckoutService.complete.mockResolvedValue(mockOrders);
+
+      const customer: Customer = {
+        id: 123,
+        customerNumber: 'CUST-123',
+        customerType: 16, // B2B
+        firstName: 'John',
+        lastName: 'Doe',
+        gender: 2,
+        title: 'Mr.',
+        dateOfBirth: '1980-01-15',
+        notificationChannels: 4,
+        features: [{ key: 'B2B_CUSTOMER', value: 'true' }],
+        communicationDetails: {
+          email: 'john.doe@example.com',
+          phone: '+49 123 456789',
+        },
+        organisation: {
+          name: 'ACME Corp',
+        },
+        address: {
+          street: 'Main St',
+          streetNumber: '42',
+          zipCode: '12345',
+          city: 'Berlin',
+          country: 'DE',
+        },
+      } as Customer;
+
+      const crmShippingAddress: CrmShippingAddressDTO = {
+        id: 789,
+        firstName: 'Jane',
+        lastName: 'Doe',
+        address: {
+          street: 'Delivery St',
+          streetNumber: '99',
+          zipCode: '54321',
+          city: 'Hamburg',
+          country: 'DE',
+        },
+      };
+
+      const crmPayer: CrmPayer = {
+        id: 999,
+        payerNumber: 'PAY-999',
+        payerType: 16,
+        payerStatus: 0,
+        firstName: 'Billing',
+        lastName: 'Department',
+        address: {
+          street: 'Billing St',
+          streetNumber: '1',
+          zipCode: '11111',
+          city: 'Munich',
+          country: 'DE',
+        },
+      } as CrmPayer;
+
+      const abortController = new AbortController();
+
+      // Act
+      const result = await facade.completeWithCrmData(
+        {
+          shoppingCartId: 456,
+          customer,
+          crmShippingAddress,
+          crmPayer,
+          notificationChannels: 8,
+        },
+        abortController.signal,
+      );
+
+      // Assert
+      expect(result).toEqual(mockOrders);
+      expect(mockCheckoutService.complete).toHaveBeenCalledWith(
+        expect.objectContaining({
+          shoppingCartId: 456,
+          buyer: expect.objectContaining({
+            reference: { id: 123 },
+            source: 123,
+            buyerType: 16,
+            buyerNumber: 'CUST-123',
+            firstName: 'John',
+            lastName: 'Doe',
+          }),
+          shippingAddress: expect.objectContaining({
+            reference: { id: 789 },
+            source: 789,
+            firstName: 'Jane',
+            lastName: 'Doe',
+          }),
+          payer: expect.objectContaining({
+            reference: { id: 999 },
+            source: 999,
+            payerType: 16,
+            payerNumber: 'PAY-999',
+          }),
+          notificationChannels: 8,
+          customerFeatures: { B2B_CUSTOMER: 'B2B_CUSTOMER' },
+        }),
+        abortController.signal,
+      );
+    });
+  });
+
+  describe('complete', () => {
+    it('should delegate to checkout service', async () => {
+      // Arrange
+      const mockOrders: Order[] = [
+        { id: 1, orderNumber: 'ORDER-001' } as Order,
+      ];
+
+      mockCheckoutService.complete.mockResolvedValue(mockOrders);
+
+      const params = {
+        shoppingCartId: 123,
+        buyer: { buyerType: 8 } as any,
+        notificationChannels: 1 as any,
+        customerFeatures: {},
+      };
+
+      // Act
+      const result = await facade.complete(params);
+
+      // Assert
+      expect(result).toEqual(mockOrders);
+      expect(mockCheckoutService.complete).toHaveBeenCalledWith(
+        params,
+        undefined,
+      );
+    });
+  });
+});
diff --git a/libs/checkout/data-access/src/lib/facades/shopping-cart.facade.ts b/libs/checkout/data-access/src/lib/facades/shopping-cart.facade.ts
index ef23f167d..1b7304266 100644
--- a/libs/checkout/data-access/src/lib/facades/shopping-cart.facade.ts
+++ b/libs/checkout/data-access/src/lib/facades/shopping-cart.facade.ts
@@ -1,11 +1,22 @@
 import { inject, Injectable } from '@angular/core';
-import { ShoppingCartService, CheckoutService } from '../services';
 import {
-  CompleteCheckoutParams,
+  ShoppingCartService,
+  CheckoutService,
+  CheckoutMetadataService,
+} from '../services';
+import {
+  CompleteOrderParams,
   RemoveShoppingCartItemParams,
   UpdateShoppingCartItemParams,
+  CompleteCrmOrderParamsSchema,
+  CompleteCrmOrderParams,
 } from '../schemas';
 import { Order } from '../models';
+import {
+  CustomerAdapter,
+  ShippingAddressAdapter,
+  PayerAdapter,
+} from '../adapters';
 
 @Injectable({ providedIn: 'root' })
 export class ShoppingCartFacade {
@@ -31,10 +42,87 @@ export class ShoppingCartFacade {
     return this.#shoppingCartService.updateItem(params);
   }
 
-  complete(
-    params: CompleteCheckoutParams,
+  /**
+   * Complete checkout and create orders.
+   *
+   * @param params - Complete checkout parameters
+   * @param abortSignal - Optional AbortSignal for cancellation
+   * @returns Promise<number> - Checkout Id
+   * @throws CheckoutCompletionError - If validation or order creation fails
+   */
+  async complete(
+    params: CompleteOrderParams,
     abortSignal?: AbortSignal,
-  ): Promise<Order[]> {
-    return this.#checkoutService.complete(params, abortSignal);
+  ): Promise<number> {
+    // Complete checkout preparation
+    return await this.#checkoutService.complete(params, abortSignal);
+  }
+
+  /**
+   * Complete order with CRM data.
+   *
+   * @remarks
+   * Accepts raw CRM data (customer, shipping address, payer) and transforms it
+   * to checkout format before completing the order. This method encapsulates
+   * the business logic of converting CRM entities to checkout entities.
+   *
+   * **Transformation Steps:**
+   * 1. Validates input parameters with Zod schema
+   * 2. Transforms customer to buyer using CustomerAdapter.toBuyer()
+   * 3. Transforms CRM shipping address (if provided) using ShippingAddressAdapter
+   * 4. Transforms CRM payer (if provided) using PayerAdapter
+   * 5. Extracts customer features using CustomerAdapter.extractCustomerFeatures()
+   * 6. Delegates to complete() with transformed data
+   *
+   * @param params - CRM order completion parameters
+   * @param abortSignal - Optional AbortSignal for cancellation
+   * @returns Promise<number> - Checkout Id
+   * @throws CheckoutCompletionError - If validation or order creation fails
+   *
+   * @example
+   * ```typescript
+   * const customer = await customerResource.value();
+   * const orders = await facade.completeWithCrmData({
+   *   shoppingCartId: 123,
+   *   customer,
+   *   crmShippingAddress: customer.shippingAddresses[0].data,
+   *   crmPayer: customer.payers[0].payer.data,
+   *   notificationChannels: customer.notificationChannels ?? 1,
+   * });
+   * ```
+   */
+  completeWithCrmData(
+    params: CompleteCrmOrderParams,
+    abortSignal?: AbortSignal,
+  ): Promise<number> {
+    // Validate input parameters
+    const validatedParams = CompleteCrmOrderParamsSchema.parse(params);
+
+    const {
+      shoppingCartId,
+      crmCustomer,
+      crmShippingAddress,
+      crmPayer,
+      notificationChannels,
+      specialComment,
+    } = validatedParams;
+
+    // Build checkout parameters
+    const checkoutParams: CompleteOrderParams = {
+      shoppingCartId,
+      buyer: CustomerAdapter.toBuyer(crmCustomer),
+      shippingAddress: ShippingAddressAdapter.fromCrmShippingAddress(
+        crmShippingAddress as any,
+      ),
+      customerFeatures: CustomerAdapter.extractCustomerFeatures(
+        crmCustomer as any,
+      ),
+      payer: PayerAdapter.toCheckoutFormat(crmPayer as any),
+      notificationChannels,
+      specialComment,
+    };
+
+    // Delegate to existing complete method
+    return this.complete(checkoutParams, abortSignal);
   }
 }
diff --git a/libs/checkout/data-access/src/lib/helpers/checkout-analysis.helpers.ts b/libs/checkout/data-access/src/lib/helpers/checkout-analysis.helpers.ts
index 2d465c801..afa5b74ce 100644
--- a/libs/checkout/data-access/src/lib/helpers/checkout-analysis.helpers.ts
+++ b/libs/checkout/data-access/src/lib/helpers/checkout-analysis.helpers.ts
@@ -1,95 +1,95 @@
-import { EntityDTOContainerOfShoppingCartItemDTO } from '@generated/swagger/checkout-api';
-import {
-  CustomerTypeAnalysis,
-  OrderOptionsAnalysis,
-  ShoppingCartItem,
-} from '../models';
-
-/**
- * Analyzes shopping cart items to determine which order types are present.
- *
- * @remarks
- * Pure function that examines the orderType feature of each item to identify:
- * - Take away orders (Rücklage)
- * - Pick up orders (Abholung)
- * - Download orders
- * - Standard delivery (Versand)
- * - Digital delivery (DIG-Versand)
- * - B2B delivery (B2B-Versand)
- *
- * Used during checkout completion to determine payment requirements and
- * destination update needs.
- *
- * @param items - Shopping cart items to analyze
- * @returns Analysis result with boolean flags for each order type and unwrapped items
- *
- * @example
- * ```typescript
- * const items = [
- *   { data: { features: { orderType: 'Versand' } } },
- *   { data: { features: { orderType: 'Abholung' } } }
- * ];
- * const analysis = analyzeOrderOptions(items);
- * // { hasDelivery: true, hasPickUp: true, hasTakeAway: false, ... }
- * ```
- */
-export function analyzeOrderOptions(
-  items: EntityDTOContainerOfShoppingCartItemDTO[],
-): OrderOptionsAnalysis {
-  return {
-    hasTakeAway: items.some(
-      (item) => item.data?.features?.['orderType'] === 'Rücklage',
-    ),
-    hasPickUp: items.some(
-      (item) => item.data?.features?.['orderType'] === 'Abholung',
-    ),
-    hasDownload: items.some(
-      (item) => item.data?.features?.['orderType'] === 'Download',
-    ),
-    hasDelivery: items.some(
-      (item) => item.data?.features?.['orderType'] === 'Versand',
-    ),
-    hasDigDelivery: items.some(
-      (item) => item.data?.features?.['orderType'] === 'DIG-Versand',
-    ),
-    hasB2BDelivery: items.some(
-      (item) => item.data?.features?.['orderType'] === 'B2B-Versand',
-    ),
-    items: items.map((d) => d.data as ShoppingCartItem),
-  };
-}
-
-/**
- * Analyzes customer features to determine customer type characteristics.
- *
- * @remarks
- * Pure function that converts feature flags into typed boolean properties:
- * - isOnline: webshop customer
- * - isGuest: guest account
- * - isB2B: business customer
- * - hasCustomerCard: loyalty card holder (Pay4More)
- * - isStaff: employee/staff member
- *
- * Used during checkout to determine payment requirements and payer necessity.
- *
- * @param features - Customer feature flags (e.g., { webshop: 'webshop', b2b: 'b2b' })
- * @returns Analysis result with boolean flags for each customer type
- *
- * @example
- * ```typescript
- * const features = { webshop: 'webshop', p4mUser: 'p4mUser' };
- * const analysis = analyzeCustomerTypes(features);
- * // { isOnline: true, hasCustomerCard: true, isB2B: false, ... }
- * ```
- */
-export function analyzeCustomerTypes(
-  features: Record<string, string>,
-): CustomerTypeAnalysis {
-  return {
-    isOnline: !!features?.['webshop'],
-    isGuest: !!features?.['guest'],
-    isB2B: !!features?.['b2b'],
-    hasCustomerCard: !!features?.['p4mUser'],
-    isStaff: !!features?.['staff'],
-  };
-}
+import {
+  CustomerTypeAnalysis,
+  OrderOptionsAnalysis,
+  ShoppingCartItem,
+} from '../models';
+import { EntityContainer } from '@isa/common/data-access';
+
+/**
+ * Analyzes shopping cart items to determine which order types are present.
+ *
+ * @remarks
+ * Pure function that examines the orderType feature of each item to identify:
+ * - Take away orders (Rücklage)
+ * - Pick up orders (Abholung)
+ * - Download orders
+ * - Standard delivery (Versand)
+ * - Digital delivery (DIG-Versand)
+ * - B2B delivery (B2B-Versand)
+ *
+ * Used during checkout completion to determine payment requirements and
+ * destination update needs.
+ *
+ * @param items - Shopping cart items to analyze
+ * @returns Analysis result with boolean flags for each order type and unwrapped items
+ *
+ * @example
+ * ```typescript
+ * const items = [
+ *   { data: { features: { orderType: 'Versand' } } },
+ *   { data: { features: { orderType: 'Abholung' } } }
+ * ];
+ * const analysis = analyzeOrderOptions(items);
+ * // { hasDelivery: true, hasPickUp: true, hasTakeAway: false, ... }
+ * ```
+ */
+export function analyzeOrderOptions(
+  items: EntityContainer<ShoppingCartItem>[],
+): OrderOptionsAnalysis {
+  return {
+    hasTakeAway: items.some(
+      (item) => item.data?.features?.['orderType'] === 'Rücklage',
+    ),
+    hasPickUp: items.some(
+      (item) => item.data?.features?.['orderType'] === 'Abholung',
+    ),
+    hasDownload: items.some(
+      (item) => item.data?.features?.['orderType'] === 'Download',
+    ),
+    hasDelivery: items.some(
+      (item) => item.data?.features?.['orderType'] === 'Versand',
+    ),
+    hasDigDelivery: items.some(
+      (item) => item.data?.features?.['orderType'] === 'DIG-Versand',
+    ),
+    hasB2BDelivery: items.some(
+      (item) => item.data?.features?.['orderType'] === 'B2B-Versand',
+    ),
+    items: items.map((d) => d.data as ShoppingCartItem),
+  };
+}
+
+/**
+ * Analyzes customer features to determine customer type characteristics.
+ *
+ * @remarks
+ * Pure function that converts feature flags into typed boolean properties:
+ * - isOnline: webshop customer
+ * - isGuest: guest account
+ * - isB2B: business customer
+ * - hasCustomerCard: loyalty card holder (Pay4More)
+ * - isStaff: employee/staff member
+ *
+ * Used during checkout to determine payment requirements and payer necessity.
+ *
+ * @param features - Customer feature flags (e.g., { webshop: 'webshop', b2b: 'b2b' })
+ * @returns Analysis result with boolean flags for each customer type
+ *
+ * @example
+ * ```typescript
+ * const features = { webshop: 'webshop', p4mUser: 'p4mUser' };
+ * const analysis = analyzeCustomerTypes(features);
+ * // { isOnline: true, hasCustomerCard: true, isB2B: false, ... }
+ * ```
+ */
+export function analyzeCustomerTypes(
+  features: Record<string, string>,
+): CustomerTypeAnalysis {
+  return {
+    isOnline: !!features?.['webshop'],
+    isGuest: !!features?.['guest'],
+    isB2B: !!features?.['b2b'],
+    hasCustomerCard: !!features?.['p4mUser'],
+    isStaff: !!features?.['staff'],
+  };
+}
diff --git a/libs/checkout/data-access/src/lib/models/availability-type.ts b/libs/checkout/data-access/src/lib/models/availability-type.ts
deleted file mode 100644
index 4624272d9..000000000
--- a/libs/checkout/data-access/src/lib/models/availability-type.ts
+++ /dev/null
@@ -1,18 +0,0 @@
-import { AvailabilityType as GeneratedAvailabilityType } from '@generated/swagger/checkout-api';
-
-export type AvailabilityType = GeneratedAvailabilityType;
-
-// Helper constants for easier usage
-export const AvailabilityType = {
-  Unknown: 0,
-  InStock: 1,
-  OutOfStock: 2,
-  PreOrder: 32,
-  BackOrder: 256,
-  Discontinued: 512,
-  OnRequest: 1024,
-  SpecialOrder: 2048,
-  DigitalDelivery: 4096,
-  PartialStock: 8192,
-  ExpectedDelivery: 16384,
-} as const;
diff --git a/libs/checkout/data-access/src/lib/models/availability.ts b/libs/checkout/data-access/src/lib/models/availability.ts
deleted file mode 100644
index 1dd07d2a1..000000000
--- a/libs/checkout/data-access/src/lib/models/availability.ts
+++ /dev/null
@@ -1,3 +0,0 @@
-import { AvailabilityDTO } from '@generated/swagger/checkout-api';
-
-export type Availability = AvailabilityDTO;
diff --git a/libs/checkout/data-access/src/lib/models/branch-type.ts b/libs/checkout/data-access/src/lib/models/branch-type.ts
index 325184983..b70dc53bb 100644
--- a/libs/checkout/data-access/src/lib/models/branch-type.ts
+++ b/libs/checkout/data-access/src/lib/models/branch-type.ts
@@ -1,11 +1,10 @@
-import { BranchType } from '@generated/swagger/checkout-api';
-
-export type BranchTypeEnum = BranchType;
-
-export const BranchTypeEnum = {
-  NotSet: 0,
-  Store: 1,
-  WebStore: 2,
-  CallCenter: 4,
-  Headquarter: 8,
-} as const;
+export const BranchType = {
+  NotSet: 0,
+  Store: 1,
+  WebStore: 2,
+  CallCenter: 4,
+  Headquarter: 8,
+  Warehouse: 16,
+} as const;
+
+export type BranchType = (typeof BranchType)[keyof typeof BranchType];
diff --git a/libs/checkout/data-access/src/lib/models/branch.ts b/libs/checkout/data-access/src/lib/models/branch.ts
deleted file mode 100644
index 9c468b8f9..000000000
--- a/libs/checkout/data-access/src/lib/models/branch.ts
+++ /dev/null
@@ -1,3 +0,0 @@
-import { BranchDTO } from '@generated/swagger/checkout-api';
-
-export type Branch = BranchDTO;
diff --git a/libs/checkout/data-access/src/lib/models/buyer.ts b/libs/checkout/data-access/src/lib/models/buyer.ts
deleted file mode 100644
index dda23c12c..000000000
--- a/libs/checkout/data-access/src/lib/models/buyer.ts
+++ /dev/null
@@ -1,6 +0,0 @@
-import { BuyerDTO } from '@generated/swagger/checkout-api';
-import { BuyerType } from '@isa/common/data-access';
-
-export type Buyer = BuyerDTO & {
-  buyerType: BuyerType;
-};
diff --git a/libs/checkout/data-access/src/lib/models/index.ts b/libs/checkout/data-access/src/lib/models/index.ts
index be212c9f4..e9db58537 100644
--- a/libs/checkout/data-access/src/lib/models/index.ts
+++ b/libs/checkout/data-access/src/lib/models/index.ts
@@ -1,28 +1,21 @@
-export * from './availability-type';
-export * from './availability';
-export * from './branch';
-export * from './buyer';
+export * from './branch-type';
 export * from './campaign';
 export * from './checkout-item';
 export * from './checkout';
 export * from './customer-type-analysis';
-export * from './destination';
 export * from './gender';
 export * from './loyalty';
 export * from './ola-availability';
 export * from './order-options';
 export * from './order-type';
 export * from './order';
-export * from './payer';
 export * from './price';
 export * from './product';
 export * from './promotion';
+export * from './reward-selection-item';
 export * from './shipping-address';
 export * from './shipping-target';
 export * from './shopping-cart-item';
-export * from './supplier';
 export * from './shopping-cart';
 export * from './update-shopping-cart-item';
 export * from './vat-type';
-export * from './reward-selection-item';
-export * from './branch-type';
diff --git a/libs/checkout/data-access/src/lib/models/payer.ts b/libs/checkout/data-access/src/lib/models/payer.ts
deleted file mode 100644
index 3c196ca80..000000000
--- a/libs/checkout/data-access/src/lib/models/payer.ts
+++ /dev/null
@@ -1,6 +0,0 @@
-import { PayerDTO } from '@generated/swagger/checkout-api';
-import { PayerType } from '@isa/common/data-access';
-
-export type Payer = PayerDTO & {
-  payerType: PayerType;
-};
diff --git a/libs/checkout/data-access/src/lib/models/supplier.ts b/libs/checkout/data-access/src/lib/models/supplier.ts
deleted file mode 100644
index efa332c15..000000000
--- a/libs/checkout/data-access/src/lib/models/supplier.ts
+++ /dev/null
@@ -1,3 +0,0 @@
-import { SupplierDTO } from '@generated/swagger/checkout-api';
-
-export type Supplier = SupplierDTO;
diff --git a/libs/checkout/data-access/src/lib/schemas/add-item-to-shopping-cart-params.schema.ts b/libs/checkout/data-access/src/lib/schemas/add-item-to-shopping-cart-params.schema.ts
index 9d28cac2e..2965e5703 100644
--- a/libs/checkout/data-access/src/lib/schemas/add-item-to-shopping-cart-params.schema.ts
+++ b/libs/checkout/data-access/src/lib/schemas/add-item-to-shopping-cart-params.schema.ts
@@ -1,56 +1,67 @@
 import { z } from 'zod';
-import {
-  AvailabilityDTOSchema,
-  CampaignDTOSchema,
-  LoyaltyDTOSchema,
-  ProductDTOSchema,
-  PromotionDTOSchema,
-  PriceSchema,
-  EntityDTOContainerOfDestinationDTOSchema,
-  ItemTypeSchema,
-  PriceValueSchema,
-} from './base-schemas';
+import { EntityContainerSchema } from '@isa/common/data-access';
+import { AvailabilitySchema } from './availability.schema';
+import { CampaignSchema } from './campaign.schema';
+import { DestinationSchema } from './destination.schema';
+import { ItemTypeSchema } from './item-type.schema';
+import { LoyaltySchema } from './loyalty.schema';
+import { PriceFlatSchema } from './price-flat.schema';
+import { ProductSchema } from './product.schema';
+import { PromotionSchema } from './promotion.schema';
 
-const AddToShoppingCartDefaultSchema = z.object({
-  availability: AvailabilityDTOSchema,
-  campaign: CampaignDTOSchema,
-  destination: EntityDTOContainerOfDestinationDTOSchema,
-  itemType: ItemTypeSchema,
-  product: ProductDTOSchema,
-  promotion: PromotionDTOSchema,
-  quantity: z.number().int().positive(),
-  retailPrice: PriceSchema,
-  shopItemId: z.number().int().positive().optional(),
+// Base schema for all add to shopping cart items
+const AddToShoppingCartBaseSchema = z.object({
+  availability: AvailabilitySchema.describe('Availability'),
+  campaign: CampaignSchema.describe('Campaign information').optional(),
+  destination: EntityContainerSchema(DestinationSchema).describe(
+    'Destination information',
+  ),
+  itemType: ItemTypeSchema.describe('Item type').optional(),
+  loyalty: LoyaltySchema.describe('Loyalty information').optional(),
+  product: ProductSchema.describe('Product').optional(),
+  promotion: PromotionSchema.describe('Promotion information').optional(),
+  quantity: z.number().int().positive().describe('Quantity'),
+  retailPrice: PriceFlatSchema.describe('Retail price').optional(),
+  shopItemId: z
+    .number()
+    .int()
+    .positive()
+    .describe('ShopItem identifier')
+    .optional(),
 });
 
-// When loyalty points are used the price value must be 0 and promotion is not allowed
-// and availability must not contain a price
-// and loyalty must be present
-const AddToShoppingCartWithRedemptionPointsSchema =
-  AddToShoppingCartDefaultSchema.omit({
-    availability: true,
-    promotion: true,
-  }).extend({
-    availability: AvailabilityDTOSchema.unwrap()
-      .omit({ price: true })
-      .extend({
-        price: PriceSchema.unwrap()
-          .omit({ value: true })
-          .extend({
-            value: PriceValueSchema.omit({ value: true }).extend({ value: z.literal(0) }),
-          }),
-      }),
-    loyalty: LoyaltyDTOSchema,
-  });
-
-const AddToShoppingCartSchema = z.union([
-  AddToShoppingCartDefaultSchema,
-  AddToShoppingCartWithRedemptionPointsSchema,
-]);
+// Apply business rules validation
+const AddToShoppingCartSchema = AddToShoppingCartBaseSchema.refine(
+  (data) => {
+    // When loyalty points are used, promotion must not be present
+    if (data.loyalty && data.promotion) {
+      return false;
+    }
+    return true;
+  },
+  {
+    message: 'Promotion is not allowed when using loyalty points',
+  },
+).refine(
+  (data) => {
+    // When loyalty points are used, price value should be 0
+    if (data.loyalty && data.availability?.price?.value?.value !== 0) {
+      return false;
+    }
+    return true;
+  },
+  {
+    message: 'Price value must be 0 when using loyalty points for redemption',
+  },
+);
 
 export const AddItemToShoppingCartParamsSchema = z.object({
-  shoppingCartId: z.number().int().positive(),
-  items: z.array(AddToShoppingCartSchema).min(1),
+  shoppingCartId: z
+    .number()
+    .int()
+    .positive()
+    .describe('Shopping cart identifier'),
+  items: z.array(AddToShoppingCartSchema).min(1).describe('List of items'),
 });
 
 export type AddItemToShoppingCartParams = z.infer<
diff --git a/libs/checkout/data-access/src/lib/schemas/allergene-type.schema.ts b/libs/checkout/data-access/src/lib/schemas/allergene-type.schema.ts
new file mode 100644
index 000000000..a540c51eb
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/allergene-type.schema.ts
@@ -0,0 +1,60 @@
+import { z } from 'zod';
+
+export const AllergeneType = {
+  NotSet: 0,
+  SulfurDioxide: 1,
+  EggWhite: 2,
+  EggYolk: 4,
+  Egg: 6,
+  Shellfish: 8,
+  Fish: 16,
+  Mollusc: 32,
+  Celery: 64,
+  Mustard: 128,
+  Sesame: 256,
+  MilkProtein: 512,
+  Lactose: 1024,
+  Milk: 1536,
+  Nuts: 2048,
+  Hazelnut: 6144,
+  Almond: 10240,
+  Walnut: 18432,
+  Cashew: 34816,
+  Pecan: 67584,
+  BrazilNut: 133120,
+  Pistachio: 264192,
+  Macadamia: 526336,
+  Gluten: 1048576,
+  Wheat: 3145728,
+  Rye: 5242880,
+  Oat: 9437184,
+  Barley: 17825792,
+  Spelt: 34603008,
+  Kamut: 68157440,
+  Emmer: 135266304,
+  Pulse: 268435456,
+  Peanuts: 805306368,
+  Soy: 1342177280,
+  Chickpea: 2415919104,
+  Lentil: 4563402752,
+  Peavine: 8858370048,
+  Lupin: 17448304640,
+  Pea: 34628173824,
+  Bean: 68987912192,
+  Cinnamon: 137438953472,
+} as const;
+
+const ALL_FLAGS = Object.values(AllergeneType).reduce<number>(
+  (a, b) => a | b,
+  0,
+);
+
+export const AllergeneTypeSchema = z
+  .nativeEnum(AllergeneType)
+  .refine(
+    (val) => (val & ~ALL_FLAGS) === 0,
+    () => ({ message: 'Invalid allergene type combination' }),
+  )
+  .describe('Allergen type classification for food items');
+
+export type AllergeneType = z.infer<typeof AllergeneTypeSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/availability-type.schema.ts b/libs/checkout/data-access/src/lib/schemas/availability-type.schema.ts
new file mode 100644
index 000000000..b978d5608
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/availability-type.schema.ts
@@ -0,0 +1,19 @@
+import { z } from 'zod';
+
+export const AvailabilityType = {
+  NotSet: 0,
+  NotAvailable: 1,
+  PrebookAtBuyer: 2,
+  PrebookAtRetailer: 32,
+  PrebookAtSupplier: 256,
+  TemporarilyNotAvailable: 512,
+  Available: 1024,
+  OnDemand: 2048,
+  AtProductionDate: 4096,
+  Discontinued: 8192,
+  EndOfLife: 16384,
+} as const;
+
+export const AvailabilityTypeSchema = z.nativeEnum(AvailabilityType).describe('Availability type');
+
+export type AvailabilityType = z.infer<typeof AvailabilityTypeSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/availability.schema.ts b/libs/checkout/data-access/src/lib/schemas/availability.schema.ts
new file mode 100644
index 000000000..55db03343
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/availability.schema.ts
@@ -0,0 +1,35 @@
+import {
+  EntityContainerSchema,
+  PriceSchema,
+  TouchBaseSchema,
+} from '@isa/common/data-access';
+import { z } from 'zod';
+import { AvailabilityTypeSchema } from './availability-type.schema';
+import { DateRangeSchema } from './data-range.schema';
+import { LogisticianSchema } from './logistician.schema';
+import { SupplierSchema } from './supplier.schema';
+
+export const AvailabilitySchema = z
+  .object({
+    availabilityType: AvailabilityTypeSchema.describe('Availability type').optional(),
+    estimatedDelivery: DateRangeSchema.describe('Estimated delivery').optional(),
+    estimatedShippingDate: z.string().describe('EstimatedShipping date').optional(),
+    inStock: z.number().describe('Whether item is in stock').optional(),
+    isPrebooked: z.boolean().describe('Whether prebooked').optional(),
+    lastRequest: z.string().describe('Last request').optional(),
+    logistician: EntityContainerSchema(LogisticianSchema).describe('Logistician information').optional(),
+    price: PriceSchema.describe('Price information').optional(),
+    requestReference: z.string().describe('Request reference').optional(),
+    shopItem: EntityContainerSchema(z.any()).describe('Shop item information').optional(),
+    ssc: z.string().describe('Ssc').optional(),
+    sscText: z.string().describe('Ssc text').optional(),
+    supplier: EntityContainerSchema(SupplierSchema).describe('Supplier information').optional(),
+    supplierInfo: z.string().describe('Supplier info').optional(),
+    supplierProductNumber: z.string().describe('SupplierProduct number').optional(),
+    supplierSSC: z.string().describe('Supplier s s c').optional(),
+    supplierSSCText: z.string().describe('Supplier s s c text').optional(),
+    supplyChannel: z.string().describe('Supply channel').optional(),
+  })
+  .extend(TouchBaseSchema.shape);
+
+export type Availability = z.infer<typeof AvailabilitySchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/avoirdupois.schema.ts b/libs/checkout/data-access/src/lib/schemas/avoirdupois.schema.ts
new file mode 100644
index 000000000..80b214225
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/avoirdupois.schema.ts
@@ -0,0 +1,22 @@
+import { z } from 'zod';
+
+export const Avoirdupois = {
+  NotSet: 0,
+  Nanogramm: 1,
+  Mikrogramm: 2,
+  Milligramm: 4,
+  Gramm: 8,
+  Kilogramm: 16,
+  MetrischeTonne: 32,
+  Zentner: 64,
+  DoppelZentner: 128,
+  MetrischesKarat: 256,
+  Grain: 512,
+  Dram: 1024,
+  Ounce: 2048,
+  Pound: 4096,
+} as const;
+
+export const AvoirdupoisSchema = z.nativeEnum(Avoirdupois).describe('Avoirdupois');
+
+export type Avoirdupois = z.infer<typeof AvoirdupoisSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/base-schemas.ts b/libs/checkout/data-access/src/lib/schemas/base-schemas.ts
index 4314a6721..ba6ecaa54 100644
--- a/libs/checkout/data-access/src/lib/schemas/base-schemas.ts
+++ b/libs/checkout/data-access/src/lib/schemas/base-schemas.ts
@@ -1,338 +1,13 @@
-import { z } from 'zod';
-import { AvailabilityType, Gender, ShippingTarget } from '../models';
-import { OrderType } from '../models';
-import { BranchTypeEnum } from '../models';
-import {
-  AddressSchema,
-  CommunicationDetailsSchema,
-  EntityContainerSchema,
-  OrganisationSchema,
-  PriceValueSchema,
-  VatTypeSchema,
-  VatValueSchema,
-} from '@isa/common/data-access';
-
-// Re-export PriceValueSchema for other checkout schemas
-export { PriceValueSchema } from '@isa/common/data-access';
-
-// ItemType from generated API - it's a numeric bitwise enum
-export const ItemTypeSchema = z.number().optional();
-
-// Enum schemas based on generated swagger types
-export const AvailabilityTypeSchema = z.nativeEnum(AvailabilityType).optional();
-export const ShippingTargetSchema = z.nativeEnum(ShippingTarget).optional();
-
-export const GenderSchema = z.nativeEnum(Gender).optional();
-
-export const OrderTypeSchema = z.nativeEnum(OrderType).optional();
-
-// Base schemas for nested objects
-export const DateRangeSchema = z
-  .object({
-    start: z.string().optional(),
-    stop: z.string().optional(),
-  })
-  .optional();
-
-// export const OrganisationSchema = z
-//   .object({
-//     name: z.string().optional(),
-//     taxNumber: z.string().optional(),
-//   })
-//   .optional();
-
-// DTO Schemas based on generated API types
-export const TouchedBaseSchema = z.object({
-  id: z.number().optional(),
-  createdAt: z.string().optional(),
-  modifiedAt: z.string().optional(),
-});
-
-export const PriceDTOSchema = z
-  .object({
-    id: z.number().optional(),
-    createdAt: z.string().optional(),
-    modifiedAt: z.string().optional(),
-    value: PriceValueSchema.optional(),
-    vat: VatValueSchema.optional(),
-  })
-  .optional();
-
-export const PriceSchema = z
-  .object({
-    currency: z.string().optional(),
-    currencySymbol: z.string().optional(),
-    validFrom: z.string().optional(),
-    value: z.number(),
-    vatInPercent: z.number().optional(),
-    vatType: VatTypeSchema.optional(),
-    vatValue: z.number().optional(),
-  })
-  .optional();
-
-export const CampaignDTOSchema = z
-  .object({
-    id: z.number().optional(),
-    createdAt: z.string().optional(),
-    modifiedAt: z.string().optional(),
-    code: z.string().optional(),
-    label: z.string().optional(),
-    type: z.string().optional(),
-    value: z.number().optional(),
-  })
-  .optional();
-
-export const PromotionDTOSchema = z
-  .object({
-    id: z.number().optional(),
-    createdAt: z.string().optional(),
-    modifiedAt: z.string().optional(),
-    code: z.string().optional(),
-    label: z.string().optional(),
-    type: z.string().optional(),
-    value: z.number().optional(),
-  })
-  .optional();
-
-export const LoyaltyDTOSchema = z
-  .object({
-    id: z.number().optional(),
-    createdAt: z.string().optional(),
-    modifiedAt: z.string().optional(),
-    code: z.string().optional(),
-    label: z.string().optional(),
-    type: z.string().optional(),
-    value: z.number().optional(),
-  })
-  .optional();
-
-export const ProductDTOSchema = z
-  .object({
-    id: z.number().optional(),
-    createdAt: z.string().optional(),
-    modifiedAt: z.string().optional(),
-    additionalName: z.string().optional(),
-    catalogProductNumber: z.string().optional(),
-    contributors: z.string().optional(),
-    ean: z.string().optional(),
-    edition: z.string().optional(),
-    format: z.string().optional(),
-    formatDetail: z.string().optional(),
-    locale: z.string().optional(),
-    manufacturer: z.string().optional(),
-    name: z.string().optional(),
-    productGroup: z.string().optional(),
-    productGroupDetails: z.string().optional(),
-    publicationDate: z.string().optional(),
-    serial: z.string().optional(),
-    supplierProductNumber: z.string().optional(),
-    volume: z.string().optional(),
-  })
-  .optional();
-
-export const LogisticianDTOSchema = z
-  .object({
-    id: z.number().optional(),
-    createdAt: z.string().optional(),
-    modifiedAt: z.string().optional(),
-    gln: z.string().optional(),
-    logisticianNumber: z.string().optional(),
-    name: z.string().optional(),
-  })
-  .optional();
-
-export const SupplierDTOSchema = z
-  .object({
-    id: z.number().optional(),
-    createdAt: z.string().optional(),
-    modifiedAt: z.string().optional(),
-    key: z.string().optional(),
-    name: z.string().optional(),
-    supplierNumber: z.string().optional(),
-    supplierType: z
-      .union([z.literal(0), z.literal(1), z.literal(2), z.literal(4)])
-      .optional(),
-  })
-  .optional();
-
-export const AvailabilityDTOSchema = z
-  .object({
-    id: z.number().optional(),
-    createdAt: z.string().optional(),
-    modifiedAt: z.string().optional(),
-    availabilityType: AvailabilityTypeSchema,
-    estimatedDelivery: DateRangeSchema,
-    estimatedShippingDate: z.string().optional(),
-    inStock: z.number().optional(),
-    isPrebooked: z.boolean().optional(),
-    lastRequest: z.string().optional(),
-    logistician: EntityContainerSchema(LogisticianDTOSchema).optional(),
-    price: PriceDTOSchema,
-    requestReference: z.string().optional(),
-    ssc: z.string().optional(),
-    sscText: z.string().optional(),
-    supplier: EntityContainerSchema(SupplierDTOSchema).optional(),
-    supplierInfo: z.string().optional(),
-    supplierProductNumber: z.string().optional(),
-    supplierSSC: z.string().optional(),
-    supplierSSCText: z.string().optional(),
-    supplyChannel: z.string().optional(),
-  })
-  .optional();
-
-// LabelDTO schema for the EntityContainerSchema
-export const LabelDTOSchema = z
-  .object({
-    id: z.number().optional(),
-    createdAt: z.string().optional(),
-    modifiedAt: z.string().optional(),
-    label: z.string().optional(),
-  })
-  .optional();
-
-export const BranchDTOSchema: z.ZodOptional<z.ZodObject<any>> = z
-  .object({
-    id: z.number().optional(),
-    createdAt: z.string().optional(),
-    modifiedAt: z.string().optional(),
-    address: AddressSchema.optional(),
-    branchNumber: z.string().optional(),
-    branchType: z.nativeEnum(BranchTypeEnum).optional(),
-    isDefault: z.string().optional(),
-    isOnline: z.boolean().optional(),
-    isOrderingEnabled: z.boolean().optional(),
-    isShippingEnabled: z.boolean().optional(),
-    key: z.string().optional(),
-    label: EntityContainerSchema(LabelDTOSchema),
-    name: z.string().optional(),
-    parent: EntityContainerSchema(
-      z.lazy((): z.ZodOptional<z.ZodObject<any>> => BranchDTOSchema),
-    ).optional(),
-    shortName: z.string().optional(),
-  })
-  .optional();
-
-export const BranchSchema = BranchDTOSchema;
-
-export const DestinationDTOSchema = z
-  .object({
-    id: z.number().optional(),
-    createdAt: z.string().optional(),
-    modifiedAt: z.string().optional(),
-    address: AddressSchema.optional(),
-    communicationDetails: CommunicationDetailsSchema.optional(),
-    firstName: z.string().optional(),
-    gender: GenderSchema,
-    lastName: z.string().optional(),
-    locale: z.string().optional(),
-    organisation: OrganisationSchema.optional(),
-    title: z.string().optional(),
-    target: ShippingTargetSchema.optional(),
-    targetBranch: EntityContainerSchema(BranchSchema).optional(),
-  })
-  .refine(
-    (data) => {
-      // targetBranch is only optional if target is 2 (Delivery)
-      // For other targets (like Branch = 1), targetBranch should be required
-      if (data?.target !== undefined && data.target !== 2) {
-        return data?.targetBranch !== undefined;
-      }
-      return true;
-    },
-    {
-      message: 'targetBranch is required when target is not Delivery (2)',
-      path: ['targetBranch'],
-    },
-  )
-  .optional();
-
-export const EntityDTOContainerOfDestinationDTOSchema = z
-  .object({
-    id: z.number().optional(),
-    data: DestinationDTOSchema,
-  })
-  .optional();
-
-// NotificationChannel is a bitwise enum
-export const NotificationChannelSchema = z.union([
-  z.literal(0),
-  z.literal(1),
-  z.literal(2),
-  z.literal(4),
-  z.literal(8),
-  z.literal(16),
-]);
-
-// EntityReferenceDTO schema
-export const EntityReferenceDTOSchema = TouchedBaseSchema.extend({
-  pId: z.string().optional(),
-  reference: z
-    .object({
-      id: z.number().optional(),
-      pId: z.string().optional(),
-    })
-    .optional(),
-  source: z.number().optional(),
-});
-
-// AddresseeWithReferenceDTO schema
-export const AddresseeWithReferenceDTOSchema = EntityReferenceDTOSchema.extend({
-  address: AddressSchema.optional(),
-  communicationDetails: CommunicationDetailsSchema.optional(),
-  firstName: z.string().optional(),
-  gender: GenderSchema,
-  lastName: z.string().optional(),
-  locale: z.string().optional(),
-  organisation: OrganisationSchema.optional(),
-  title: z.string().optional(),
-});
-
-// BuyerStatus and PayerStatus enum schemas (bitwise enums matching generated API)
-export const BuyerStatusSchema = z.union([
-  z.literal(0),
-  z.literal(1),
-  z.literal(2),
-  z.literal(4),
-  z.literal(8),
-  z.literal(16),
-]);
-
-export const PayerStatusSchema = z.union([
-  z.literal(0),
-  z.literal(1),
-  z.literal(2),
-  z.literal(4),
-  z.literal(8),
-  z.literal(16),
-]);
-
-export const BuyerTypeSchema = z.union([
-  z.literal(0),
-  z.literal(1),
-  z.literal(2),
-  z.literal(4),
-  z.literal(8),
-  z.literal(16),
-]);
-export const PayerTypeSchema = z.union([
-  z.literal(0),
-  z.literal(4),
-  z.literal(8),
-  z.literal(16),
-]);
-
-// BuyerDTO schema
-export const BuyerDTOSchema = AddresseeWithReferenceDTOSchema.extend({
-  buyerNumber: z.string().optional(),
-  buyerStatus: BuyerStatusSchema.optional(),
-  buyerType: BuyerTypeSchema,
-  dateOfBirth: z.string().optional(),
-  isTemporaryAccount: z.boolean().optional(),
-});
-
-// PayerDTO schema
-export const PayerDTOSchema = AddresseeWithReferenceDTOSchema.extend({
-  payerNumber: z.string().optional(),
-  payerStatus: PayerStatusSchema.optional(),
-  payerType: PayerTypeSchema,
-});
+import { z } from 'zod';
+
+// OrderType is a union of specific string literals
+export const OrderTypeSchema = z.union([
+  z.literal('Rücklage'),
+  z.literal('Abholung'),
+  z.literal('Versand'),
+  z.literal('DIG-Versand'),
+  z.literal('B2B-Versand'),
+  z.literal('Download'),
+]).describe('Order type');
+
+export type OrderType = z.infer<typeof OrderTypeSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/branch-type.schema.ts b/libs/checkout/data-access/src/lib/schemas/branch-type.schema.ts
new file mode 100644
index 000000000..ba08cf7fc
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/branch-type.schema.ts
@@ -0,0 +1,4 @@
+import { z } from 'zod';
+import { BranchType } from '../models';
+
+export const BranchTypeSchema = z.nativeEnum(BranchType).describe('Branch type');
diff --git a/libs/checkout/data-access/src/lib/schemas/branch.schema.ts b/libs/checkout/data-access/src/lib/schemas/branch.schema.ts
new file mode 100644
index 000000000..496190a05
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/branch.schema.ts
@@ -0,0 +1,29 @@
+import {
+  AddressSchema,
+  EntityContainerSchema,
+  LabelSchema,
+} from '@isa/common/data-access';
+import { z } from 'zod';
+import { BranchType } from '../models';
+
+export const BranchSchema = z.object({
+  id: z.number().describe('Unique identifier').optional(),
+  createdAt: z.string().describe('Creation timestamp').optional(),
+  modifiedAt: z.string().describe('Modified at').optional(),
+  address: AddressSchema.describe('Branch physical address').optional(),
+  branchNumber: z.string().describe('Branch number identifier').optional(),
+  branchType: z.nativeEnum(BranchType).describe('Branch type classification').optional(),
+  isDefault: z.string().describe('Whether this is the default branch').optional(),
+  isOnline: z.boolean().describe('Whether branch is online').optional(),
+  isOrderingEnabled: z.boolean().describe('Whether ordering is enabled for this branch').optional(),
+  isShippingEnabled: z.boolean().describe('Whether shipping is enabled for this branch').optional(),
+  key: z.string().describe('Unique branch key identifier').optional(),
+  label: EntityContainerSchema(LabelSchema).describe('Branch label information'),
+  name: z.string().describe('Branch name').optional(),
+  parent: EntityContainerSchema(
+    z.lazy((): z.ZodType<any> => BranchSchema),
+  ).describe('Parent branch entity').optional(),
+  shortName: z.string().describe('Branch short name').optional(),
+});
+
+export type Branch = z.infer<typeof BranchSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/buyer-status.schema.ts b/libs/checkout/data-access/src/lib/schemas/buyer-status.schema.ts
new file mode 100644
index 000000000..0bae0e081
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/buyer-status.schema.ts
@@ -0,0 +1,14 @@
+import { z } from 'zod';
+
+export const BuyerStatus = {
+  NotSet: 0,
+  Blocked: 1,
+  Check: 2,
+  LowDegreeOfCreditworthiness: 4,
+  Dunning1: 8,
+  Dunning2: 16,
+} as const;
+
+export const BuyerStatusSchema = z.nativeEnum(BuyerStatus).describe('Buyer status');
+
+export type BuyerStatus = z.infer<typeof BuyerStatusSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/buyer.schema.ts b/libs/checkout/data-access/src/lib/schemas/buyer.schema.ts
new file mode 100644
index 000000000..3933ee9c8
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/buyer.schema.ts
@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import {
+  AddresseeWithReferenceSchema,
+  BuyerTypeSchema,
+} from '@isa/common/data-access';
+import { BuyerStatusSchema } from './buyer-status.schema';
+
+export const BuyerSchema = z
+  .object({
+    buyerNumber: z.string().describe('Unique buyer identifier number').optional(),
+    buyerStatus: BuyerStatusSchema.describe('Current status of the buyer account').optional(),
+    buyerType: BuyerTypeSchema.describe('Buyer type').optional(),
+    dateOfBirth: z.string().describe('Date of birth').optional(),
+    isTemporaryAccount: z.boolean().describe('Whether temporaryAccount').optional(),
+  })
+  .extend(AddresseeWithReferenceSchema.shape);
+
+export type Buyer = z.infer<typeof BuyerSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/campaign.schema.ts b/libs/checkout/data-access/src/lib/schemas/campaign.schema.ts
new file mode 100644
index 000000000..0a22e4258
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/campaign.schema.ts
@@ -0,0 +1,11 @@
+import { TouchBaseSchema } from '@isa/common/data-access';
+import { z } from 'zod';
+
+export const CampaignSchema = z
+  .object({
+    code: z.string().describe('Code value').optional(),
+    label: z.string().describe('Label').optional(),
+    type: z.string().describe('Type').optional(),
+    value: z.number().describe('Value').optional(),
+  })
+  .extend(TouchBaseSchema.shape);
diff --git a/libs/checkout/data-access/src/lib/schemas/can-add-items-to-shopping-cart-params.schema.ts b/libs/checkout/data-access/src/lib/schemas/can-add-items-to-shopping-cart-params.schema.ts
index b31ce816d..e8b66eb99 100644
--- a/libs/checkout/data-access/src/lib/schemas/can-add-items-to-shopping-cart-params.schema.ts
+++ b/libs/checkout/data-access/src/lib/schemas/can-add-items-to-shopping-cart-params.schema.ts
@@ -1,56 +1,70 @@
-import { ItemPayload } from '@generated/swagger/checkout-api';
 import { z } from 'zod';
 import { OrderTypeSchema } from './base-schemas';
 
 const CanAddPriceSchema = z.object({
   value: z
+
     .object({
-      value: z.number().optional(),
-      currency: z.string().optional(),
-      currencySymbol: z.string().optional(),
+      value: z.number().describe('Value').optional(),
+      currency: z.string().describe('Currency code').optional(),
+      currencySymbol: z.string().describe('Currency symbol').optional(),
     })
+    .describe('Value')
     .optional(),
   vat: z
+
     .object({
-      inPercent: z.number().optional(),
-      label: z.string().optional(),
-      value: z.number().optional(),
-      vatType: z.number().optional(),
+      inPercent: z.number().describe('In percent').optional(),
+      label: z.string().describe('Label').optional(),
+      value: z.number().describe('Value').optional(),
+      vatType: z.number().describe('VAT type').optional(),
     })
+    .describe('Value Added Tax')
     .optional(),
 });
 
 const CanAddOLAAvailabilitySchema = z.object({
-  altAt: z.string().optional(),
-  at: z.string().optional(),
-  ean: z.string().optional(),
-  format: z.string().optional(),
-  isPrebooked: z.boolean().optional(),
-  itemId: z.number().int().optional(),
-  logistician: z.string().optional(),
-  logisticianId: z.number().int().optional(),
-  preferred: z.number().int().optional(),
-  price: CanAddPriceSchema.optional(),
-  qty: z.number().int().optional(),
-  shop: z.number().int().optional(),
-  ssc: z.string().optional(),
-  sscText: z.string().optional(),
-  status: z.number().int(),
-  supplier: z.string().optional(),
-  supplierId: z.number().int().optional(),
-  supplierProductNumber: z.string().optional(),
+  altAt: z.string().describe('Alt at').optional(),
+  at: z.string().describe('At').optional(),
+  ean: z.string().describe('European Article Number barcode').optional(),
+  format: z.string().describe('Format').optional(),
+  isPrebooked: z.boolean().describe('Whether prebooked').optional(),
+  itemId: z.number().int().describe('Unique item identifier').optional(),
+  logistician: z.string().describe('Logistician information').optional(),
+  logisticianId: z.number().int().describe('Logistician identifier').optional(),
+  preferred: z.number().int().describe('Preferred').optional(),
+  price: CanAddPriceSchema.describe('Price information').optional(),
+  qty: z.number().int().describe('Qty').optional(),
+  shop: z.number().int().describe('Shop').optional(),
+  ssc: z.string().describe('Ssc').optional(),
+  sscText: z.string().describe('Ssc text').optional(),
+  status: z.number().int().describe('Current status'),
+  supplier: z.string().describe('Supplier information').optional(),
+  supplierId: z.number().int().describe('Supplier identifier').optional(),
+  supplierProductNumber: z
+    .string()
+    .describe('SupplierProduct number')
+    .optional(),
 });
 
 const CanAddItemPayloadSchema = z.object({
-  availabilities: z.array(CanAddOLAAvailabilitySchema),
-  customerFeatures: z.record(z.string().optional()),
-  orderType: OrderTypeSchema,
-  id: z.string(),
+  availabilities: z
+    .array(CanAddOLAAvailabilitySchema)
+    .describe('Availabilities'),
+  customerFeatures: z
+    .record(z.string().optional())
+    .describe('Customer features'),
+  orderType: OrderTypeSchema.describe('Order type'),
+  id: z.string().describe('Unique identifier'),
 });
 
 export const CanAddItemsToShoppingCartParamsSchema = z.object({
-  shoppingCartId: z.number().int().positive(),
-  payload: z.array(CanAddItemPayloadSchema).min(1),
+  shoppingCartId: z
+    .number()
+    .int()
+    .positive()
+    .describe('Shopping cart identifier'),
+  payload: z.array(CanAddItemPayloadSchema).min(1).describe('Payload'),
 });
 
 export type CanAddItemsToShoppingCartParams = z.infer<
diff --git a/libs/checkout/data-access/src/lib/schemas/category.schema.ts b/libs/checkout/data-access/src/lib/schemas/category.schema.ts
new file mode 100644
index 000000000..725d44bb1
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/category.schema.ts
@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { EntitySchema, EntityContainerSchema } from '@isa/common/data-access';
+
+export const CategorySchema: z.ZodType<{
+  changed?: string;
+  created?: string;
+  id?: number;
+  pId?: string;
+  status?: number;
+  uId?: string;
+  version?: number;
+  name?: string;
+  parent?: {
+    id?: number;
+    pId?: string;
+    uId?: string;
+    data?: any;
+  };
+  type?: string;
+  key?: string;
+  sort?: number;
+  start?: string;
+  stop?: string;
+  tenant?: {
+    id?: number;
+    pId?: string;
+    uId?: string;
+    data?: any;
+  };
+}> = EntitySchema.extend({
+  name: z.string().describe('Name').optional(),
+  parent: z.lazy(() => EntityContainerSchema(CategorySchema)).describe('Parent').optional(),
+  type: z.string().describe('Type').optional(),
+  key: z.string().describe('Key').optional(),
+  sort: z.number().int().describe('Sort criteria').optional(),
+  start: z.string().describe('Start').optional(),
+  stop: z.string().describe('Stop').optional(),
+  tenant: EntityContainerSchema(z.any()).describe('Tenant identifier').optional(),
+});
+
+export type Category = z.infer<typeof CategorySchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/company.schema.ts b/libs/checkout/data-access/src/lib/schemas/company.schema.ts
new file mode 100644
index 000000000..85c508726
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/company.schema.ts
@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { EntitySchema, EntityContainerSchema, AddressSchema } from '@isa/common/data-access';
+
+export const CompanySchema: z.ZodType<{
+  changed?: string;
+  created?: string;
+  id?: number;
+  pId?: string;
+  status?: number;
+  uId?: string;
+  version?: number;
+  parent?: {
+    id?: number;
+    pId?: string;
+    uId?: string;
+    data?: any;
+  };
+  companyNumber?: string;
+  locale?: string;
+  name?: string;
+  nameSuffix?: string;
+  legalForm?: string;
+  department?: string;
+  costUnit?: string;
+  vatId?: string;
+  address?: {
+    street?: string;
+    streetNumber?: string;
+    postalCode?: string;
+    city?: string;
+    country?: string;
+    additionalInfo?: string;
+  };
+  gln?: string;
+  sector?: string;
+}> = EntitySchema.extend({
+  parent: z.lazy(() => EntityContainerSchema(CompanySchema)).describe('Parent').optional(),
+  companyNumber: z.string().describe('Company number').optional(),
+  locale: z.string().describe('Locale').optional(),
+  name: z.string().max(64).describe('Name').optional(),
+  nameSuffix: z.string().max(64).describe('Name suffix').optional(),
+  legalForm: z.string().max(64).describe('Legal form').optional(),
+  department: z.string().max(64).describe('Department').optional(),
+  costUnit: z.string().max(64).describe('Cost unit').optional(),
+  vatId: z.string().max(16).describe('Vat identifier').optional(),
+  address: AddressSchema.describe('Address').optional(),
+  gln: z.string().max(64).describe('Gln').optional(),
+  sector: z.string().max(64).describe('Sector').optional(),
+});
+
+export type Company = z.infer<typeof CompanySchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/complete-checkout-params.schema.ts b/libs/checkout/data-access/src/lib/schemas/complete-checkout-params.schema.ts
deleted file mode 100644
index 83e2efbc3..000000000
--- a/libs/checkout/data-access/src/lib/schemas/complete-checkout-params.schema.ts
+++ /dev/null
@@ -1,64 +0,0 @@
-import { z } from 'zod';
-import {
-  BuyerDTOSchema,
-  PayerDTOSchema,
-  NotificationChannelSchema,
-} from './base-schemas';
-import { ShippingAddressSchema } from './shipping-address.schema';
-
-/**
- * Schema for checkout completion parameters.
- *
- * @remarks
- * This schema validates all data required to complete a checkout without accessing state management.
- * All customer and order information must be provided as parameters.
- */
-export const CompleteCheckoutParamsSchema = z.object({
-  /**
-   * ID of the shopping cart to process
-   * The checkout will be created/refreshed from this shopping cart
-   */
-  shoppingCartId: z.number().int().positive(),
-
-  /**
-   * Buyer information (required)
-   * Will be set on the checkout before order creation
-   */
-  buyer: BuyerDTOSchema,
-
-  /**
-   * Notification channels for customer communications (required)
-   */
-  notificationChannels: NotificationChannelSchema,
-
-  /**
-   * Customer features for business logic determination
-   * Used to analyze customer type and determine order handling
-   */
-  customerFeatures: z.record(z.string(), z.string()),
-
-  /**
-   * Payer information (optional)
-   * Required only for B2B, delivery, or download orders
-   */
-  payer: PayerDTOSchema.optional(),
-
-  /**
-   * Shipping address (optional)
-   * Required only for delivery orders
-   * Will be merged into destination objects
-   */
-  shippingAddress: ShippingAddressSchema.optional(),
-
-  /**
-   * Special comment to apply to all shopping cart items (optional)
-   */
-  specialComment: z.string().optional(),
-});
-
-/**
- * TypeScript type inferred from the Zod schema
- */
-export type CompleteCheckoutParams = z.infer<
-  typeof CompleteCheckoutParamsSchema
->;
diff --git a/libs/checkout/data-access/src/lib/schemas/complete-order-params.schema.ts b/libs/checkout/data-access/src/lib/schemas/complete-order-params.schema.ts
new file mode 100644
index 000000000..e9dbc7f63
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/complete-order-params.schema.ts
@@ -0,0 +1,97 @@
+import { z } from 'zod';
+import { NotificationChannelSchema } from '@isa/common/data-access';
+import {
+  CustomerSchema,
+  PayerSchema as CrmPayerSchema,
+  ShippingAddressSchema as CrmShippingAddressSchema,
+} from '@isa/crm/data-access';
+import { BuyerSchema } from './buyer.schema';
+import { PayerSchema } from './payer.schema';
+import { ShippingAddressSchema } from './shipping-address.schema';
+
+/**
+ * Schema for checkout completion parameters.
+ *
+ * @remarks
+ * This schema validates all data required to complete a checkout without accessing state management.
+ * All customer and order information must be provided as parameters.
+ */
+export const CompleteOrderParamsSchema = z.object({
+  /**
+   * ID of the shopping cart to process
+   * The checkout will be created/refreshed from this shopping cart
+   */
+  shoppingCartId: z
+    .number()
+    .int()
+    .positive()
+    .describe('Shopping cart identifier'),
+
+  /**
+   * Buyer information (required)
+   * Will be set on the checkout before order creation
+   */
+  buyer: BuyerSchema.describe('Buyer information'),
+
+  /**
+   * Notification channels for customer communications (required)
+   */
+  notificationChannels: NotificationChannelSchema.describe(
+    'Notification channels',
+  ).optional(),
+
+  /**
+   * Customer features for business logic determination
+   * Used to analyze customer type and determine order handling
+   */
+  customerFeatures: z.record(
+    z.string().describe('Customer features'),
+    z.string(),
+  ),
+
+  /**
+   * Payer information (optional)
+   * Required only for B2B, delivery, or download orders
+   */
+  payer: PayerSchema.describe('Payer information').optional(),
+
+  /**
+   * Shipping address (optional)
+   * Required only for delivery orders
+   * Will be merged into destination objects
+   */
+  shippingAddress: ShippingAddressSchema.describe(
+    'Shipping address information',
+  ).optional(),
+
+  /**
+   * Special comment to apply to all shopping cart items (optional)
+   */
+  specialComment: z.string().describe('Special comment').optional(),
+});
+
+/**
+ * TypeScript type inferred from the Zod schema
+ */
+export type CompleteOrderParams = z.infer<typeof CompleteOrderParamsSchema>;
+
+export const CompleteCrmOrderParamsSchema = z.object({
+  shoppingCartId: z
+    .number()
+    .int()
+    .positive()
+    .describe('Shopping cart identifier'),
+  crmCustomer: CustomerSchema.describe('Crm customer'),
+  crmPayer: CrmPayerSchema.describe('Crm payer').optional(),
+  crmShippingAddress: CrmShippingAddressSchema.describe(
+    'Crm shipping address',
+  ).optional(),
+  notificationChannels: NotificationChannelSchema.describe(
+    'Notification channels',
+  ).optional(),
+  specialComment: z.string().describe('Special comment').optional(),
+});
+
+export type CompleteCrmOrderParams = z.infer<
+  typeof CompleteCrmOrderParamsSchema
+>;
diff --git a/libs/checkout/data-access/src/lib/schemas/component-item-display-type.schema.ts b/libs/checkout/data-access/src/lib/schemas/component-item-display-type.schema.ts
new file mode 100644
index 000000000..966685e2b
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/component-item-display-type.schema.ts
@@ -0,0 +1,15 @@
+import { z } from 'zod';
+
+export const ComponentItemDisplayType = {
+  Visible: 0,
+  Hidden: 1,
+  Emphasize: 2,
+} as const;
+
+export const ComponentItemDisplayTypeSchema = z.nativeEnum(
+  ComponentItemDisplayType,
+).describe('ComponentItemDisplay type');
+
+export type ComponentItemDisplayType = z.infer<
+  typeof ComponentItemDisplayTypeSchema
+>;
diff --git a/libs/checkout/data-access/src/lib/schemas/component-item.schema.ts b/libs/checkout/data-access/src/lib/schemas/component-item.schema.ts
new file mode 100644
index 000000000..aac9c85b8
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/component-item.schema.ts
@@ -0,0 +1,27 @@
+import {
+  EntityContainerSchema,
+  QuantityUnitTypeSchema,
+  TouchBaseSchema,
+} from '@isa/common/data-access';
+import { z } from 'zod';
+import { CategorySchema } from './category.schema';
+import { ComponentItemDisplayTypeSchema } from './component-item-display-type.schema';
+
+export const ComponentItemSchema = z
+  .object({
+    name: z.string().describe('Name').optional(),
+    description: z.string().describe('Description text').optional(),
+    item: EntityContainerSchema(z.lazy(() => z.any())).describe('Item').optional(), // ItemSchema would create circular dependency
+    category: EntityContainerSchema(CategorySchema).describe('Category information').optional(),
+    required: z.boolean().describe('Whether this is required').optional(),
+    quantityMin: z.number().describe('Quantity min').optional(),
+    quantityMax: z.number().describe('Quantity max').optional(),
+    quantityUnitType: QuantityUnitTypeSchema.describe('QuantityUnit type').optional(),
+    unit: z.string().describe('Unit').optional(),
+    displayType: ComponentItemDisplayTypeSchema.describe('Display type').optional(),
+    start: z.string().describe('Start').optional(),
+    stop: z.string().describe('Stop').optional(),
+  })
+  .extend(TouchBaseSchema.shape);
+
+export type ComponentItem = z.infer<typeof ComponentItemSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/components.schema.ts b/libs/checkout/data-access/src/lib/schemas/components.schema.ts
new file mode 100644
index 000000000..aaf5ef7b0
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/components.schema.ts
@@ -0,0 +1,21 @@
+import {
+  EntitySchema,
+  QuantityUnitTypeSchema,
+} from '@isa/common/data-access';
+import { z } from 'zod';
+import { ComponentItemSchema } from './component-item.schema';
+import { SetTypeSchema } from './set-type.schema';
+
+export const ComponentsSchema = z
+  .object({
+    items: z.array(ComponentItemSchema).describe('List of items').optional(),
+    type: SetTypeSchema.describe('Type').optional(),
+    overallQuantityMin: z.number().describe('Overall quantity min').optional(),
+    overallQuantityMax: z.number().describe('Overall quantity max').optional(),
+    quantityUnitType: QuantityUnitTypeSchema.describe('QuantityUnit type').optional(),
+    unit: z.string().describe('Unit').optional(),
+    referenceQuantity: z.number().describe('Reference quantity').optional(),
+  })
+  .extend(EntitySchema.shape);
+
+export type Components = z.infer<typeof ComponentsSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/contributor-helper.schema.ts b/libs/checkout/data-access/src/lib/schemas/contributor-helper.schema.ts
new file mode 100644
index 000000000..e39198017
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/contributor-helper.schema.ts
@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { TouchBaseSchema, EntityContainerSchema } from '@isa/common/data-access';
+
+export const ContributorHelperSchema = TouchBaseSchema.extend({
+  type: z.string().describe('Type').optional(),
+  contributor: EntityContainerSchema(z.any()).describe('Contributor information').optional(),
+});
+
+export type ContributorHelper = z.infer<typeof ContributorHelperSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/data-range.schema.ts b/libs/checkout/data-access/src/lib/schemas/data-range.schema.ts
new file mode 100644
index 000000000..3d1636248
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/data-range.schema.ts
@@ -0,0 +1,11 @@
+import { TouchBaseSchema } from '@isa/common/data-access';
+import { z } from 'zod';
+
+export const DateRangeSchema = z
+  .object({
+    start: z.string().describe('Start').optional(),
+    stop: z.string().describe('Stop').optional(),
+  })
+  .extend(TouchBaseSchema.shape);
+
+export type DateRange = z.infer<typeof DateRangeSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/declarable-food-additives.schema.ts b/libs/checkout/data-access/src/lib/schemas/declarable-food-additives.schema.ts
new file mode 100644
index 000000000..d8391f0b1
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/declarable-food-additives.schema.ts
@@ -0,0 +1,30 @@
+import { z } from 'zod';
+
+export const DeclarableFoodAdditives = {
+  NotSet: 0,
+  NatriumcyclymatUndSaccarinNatrium: 1,
+  Suessungsmitteln: 2,
+  Phenylaninquelle: 4,
+  MitEinerZuckerartUndSuessungsmitteln: 8,
+  Geschmacksverstaerker: 16,
+  Geschwefelt: 32,
+  Geschwaerzt: 64,
+  Gewachst: 128,
+  Phosphat: 256,
+  Konservierungsstoff: 512,
+  Farbstoff: 1024,
+  Antioxidationsmittel: 2048,
+  Koffeinhaltig: 4096,
+  Saeurungsmittel: 8192,
+  Rauch: 16384,
+  Lachsersatz: 32768,
+  Vorderschinken: 65536,
+} as const;
+
+export const DeclarableFoodAdditivesSchema = z.nativeEnum(
+  DeclarableFoodAdditives,
+).describe('Declarable food additives');
+
+export type DeclarableFoodAdditives = z.infer<
+  typeof DeclarableFoodAdditivesSchema
+>;
diff --git a/libs/checkout/data-access/src/lib/schemas/destination.schema.ts b/libs/checkout/data-access/src/lib/schemas/destination.schema.ts
new file mode 100644
index 000000000..f537837b2
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/destination.schema.ts
@@ -0,0 +1,34 @@
+import {
+  AddressSchema,
+  CommunicationDetailsSchema,
+  EntityContainerSchema,
+  GenderSchema,
+  OrganisationSchema,
+} from '@isa/common/data-access';
+import { z } from 'zod';
+import { ShippingTargetSchema } from './shipping-target.schema';
+import { BranchSchema } from './branch.schema';
+
+export const DestinationSchema = z.object({
+  id: z.number().describe('Unique identifier').optional(),
+  createdAt: z.string().describe('Creation timestamp').optional(),
+  modifiedAt: z.string().describe('Modified at').optional(),
+  address: AddressSchema.describe('Address').optional(),
+  communicationDetails: CommunicationDetailsSchema.describe(
+    'Communication details',
+  ).optional(),
+  firstName: z.string().describe('First name').optional(),
+  gender: GenderSchema.describe('Gender').default(0),
+  lastName: z.string().describe('Last name').optional(),
+  locale: z.string().describe('Locale').optional(),
+  organisation: OrganisationSchema.describe(
+    'Organisation information',
+  ).optional(),
+  title: z.string().describe('Title').optional(),
+  target: ShippingTargetSchema.describe('Target').optional(),
+  targetBranch: EntityContainerSchema(BranchSchema)
+    .describe('Target branch')
+    .optional(),
+});
+
+export type Destination = z.infer<typeof DestinationSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/file.schema.ts b/libs/checkout/data-access/src/lib/schemas/file.schema.ts
new file mode 100644
index 000000000..6527aad82
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/file.schema.ts
@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { EntitySchema } from '@isa/common/data-access';
+
+export const FileSchema = EntitySchema.extend({
+  name: z.string().describe('Name').optional(),
+  type: z.string().describe('Type').optional(),
+  path: z.string().describe('Path').optional(),
+  mime: z.string().describe('Mime').optional(),
+  hash: z.string().describe('Whether has h').optional(),
+  size: z.number().describe('Size').optional(),
+  subtitle: z.string().describe('Subtitle').optional(),
+  copyright: z.string().describe('Copyright').optional(),
+  locale: z.string().describe('Locale').optional(),
+  license: z.string().describe('License').optional(),
+  sort: z.number().int().describe('Sort criteria').optional(),
+});
+
+export type File = z.infer<typeof FileSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/food-label.schema.ts b/libs/checkout/data-access/src/lib/schemas/food-label.schema.ts
new file mode 100644
index 000000000..917d120e7
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/food-label.schema.ts
@@ -0,0 +1,26 @@
+import { z } from 'zod';
+
+export const FoodLabel = {
+  NotSet: 0,
+  Organic: 1,
+  Vegetarian: 2,
+  Vegan: 4,
+  Halal: 8,
+  Kashrut: 16,
+  Pasteurised: 32,
+  ExtendedShelfLife: 64,
+  UltraHighTemperature: 128,
+  RawFood: 256,
+  NotSuitableForPregnantWomen: 512,
+  NotSuitableForChildren: 1024,
+  ContainsAlcolhol: 3584,
+  ContainsCaffein: 5632,
+  ContainsBeef: 8192,
+  ContainsPork: 16384,
+  ContainsFish: 32768,
+  ContainsRawMilk: 66048,
+} as const;
+
+export const FoodLabelSchema = z.nativeEnum(FoodLabel).describe('Food label');
+
+export type FoodLabel = z.infer<typeof FoodLabelSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/food.schema.ts b/libs/checkout/data-access/src/lib/schemas/food.schema.ts
new file mode 100644
index 000000000..9bb3f0a39
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/food.schema.ts
@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { TouchBaseSchema } from '@isa/common/data-access';
+import { FoodLabelSchema } from './food-label.schema';
+import { AllergeneTypeSchema } from './allergene-type.schema';
+import { DeclarableFoodAdditivesSchema } from './declarable-food-additives.schema';
+import { NutritionFactsSchema } from './nutrition-facts.schema';
+
+export const FoodSchema = TouchBaseSchema.extend({
+  alcohol: z.number().describe('Alcohol').optional(),
+  foodLabel: FoodLabelSchema.describe('Food label information').optional(),
+  allergenes: AllergeneTypeSchema.describe('Allergenes').optional(),
+  allergenesDescription: z.string().describe('Allergenes description').optional(),
+  mayContainTracesOf: AllergeneTypeSchema.describe('May contain traces of').optional(),
+  mayContainTracesOfDescription: z.string().describe('May contain traces of description').optional(),
+  declarableFoodAdditives: DeclarableFoodAdditivesSchema.describe('Declarable food additives').optional(),
+  nutritionFacts: NutritionFactsSchema.describe('Nutrition facts information').optional(),
+});
+
+export type Food = z.infer<typeof FoodSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/image.schema.ts b/libs/checkout/data-access/src/lib/schemas/image.schema.ts
new file mode 100644
index 000000000..41709cd51
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/image.schema.ts
@@ -0,0 +1,9 @@
+import { z } from 'zod';
+
+export const ImageSchema = z.object({
+  alt: z.string().describe('Alt').optional(),
+  path: z.string().describe('Path').optional(),
+  subtitle: z.string().describe('Subtitle').optional(),
+});
+
+export type Image = z.infer<typeof ImageSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/index.ts b/libs/checkout/data-access/src/lib/schemas/index.ts
index db3ba4233..2b9192a82 100644
--- a/libs/checkout/data-access/src/lib/schemas/index.ts
+++ b/libs/checkout/data-access/src/lib/schemas/index.ts
@@ -1,6 +1,56 @@
 export * from './add-item-to-shopping-cart-params.schema';
-export * from './base-schemas';
+export * from './allergene-type.schema';
+export * from './availability-type.schema';
+export * from './availability.schema';
+export * from './avoirdupois.schema';
+export * from './branch-type.schema';
+export * from './branch.schema';
+export * from './buyer-status.schema';
+export * from './buyer.schema';
 export * from './can-add-items-to-shopping-cart-params.schema';
-export * from './complete-checkout-params.schema';
+export * from './campaign.schema';
+export * from './category.schema';
+export * from './company.schema';
+export * from './component-item-display-type.schema';
+export * from './component-item.schema';
+export * from './components.schema';
+export * from './complete-order-params.schema';
+export * from './contributor-helper.schema';
+export * from './data-range.schema';
+export * from './declarable-food-additives.schema';
+export * from './destination.schema';
+export * from './file.schema';
+export * from './food-label.schema';
+export * from './food.schema';
+export * from './image.schema';
+export * from './item-label.schema';
+export * from './item-type.schema';
+export * from './item.schema';
+export * from './logistician.schema';
+export * from './loyalty.schema';
+export * from './notification-channel.schema';
+export * from './nutrition-fact-type.schema';
+export * from './nutrition-fact.schema';
+export * from './nutrition-facts.schema';
+export * from './payer-status.schema';
+export * from './payer-type.schema';
+export * from './payer.schema';
+export * from './payment-type.schema';
+export * from './price-flat.schema';
+export * from './product.schema';
+export * from './promotion.schema';
+export * from './quantity-unit-type.schema';
 export * from './remove-shopping-cart-item-params.schema';
+export * from './rezeptmasz.schema';
+export * from './set-type.schema';
+export * from './shipping-address.schema';
+export * from './shipping-target.schema';
+export * from './shop-item.schema';
+export * from './size.schema';
+export * from './supplier-type.schema';
+export * from './supplier.schema';
+export * from './tenant.schema';
+export * from './text.schema';
 export * from './update-shopping-cart-item-params.schema';
+export * from './url.schema';
+export * from './weight.schema';
diff --git a/libs/checkout/data-access/src/lib/schemas/item-label.schema.ts b/libs/checkout/data-access/src/lib/schemas/item-label.schema.ts
new file mode 100644
index 000000000..5d8e82eab
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/item-label.schema.ts
@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import { TouchBaseSchema } from '@isa/common/data-access';
+
+export const ItemLabelSchema = TouchBaseSchema.extend({
+  labelType: z.string().describe('Label type').optional(),
+  cultureInfo: z.string().describe('Culture info').optional(),
+  value: z.string().describe('Value').optional(),
+});
+
+export type ItemLabel = z.infer<typeof ItemLabelSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/item-type.schema.ts b/libs/checkout/data-access/src/lib/schemas/item-type.schema.ts
new file mode 100644
index 000000000..66c261695
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/item-type.schema.ts
@@ -0,0 +1,27 @@
+import { z } from 'zod';
+
+export const ItemType = {
+  NotSet: 0,
+  SingleUnit: 1,
+  SalesUnit: 2,
+  Set: 4,
+  PackagingUnit: 8,
+  Configurable: 16,
+  Discount: 32,
+  Percentaged: 64,
+  FixedPrice: 128,
+  Postage: 256,
+  HandlingFee: 512,
+  Voucher: 1024,
+  ComponentList: 2048,
+  Download: 4096,
+  Streaming: 8192,
+  ItemPrice: 16384,
+  SingleUnitItemPrice: 16385,
+  ComponentPrice: 32768,
+  CustomPrice: 65536,
+} as const;
+
+export const ItemTypeSchema = z.nativeEnum(ItemType).describe('Item type');
+
+export type ItemType = z.infer<typeof ItemTypeSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/item.schema.ts b/libs/checkout/data-access/src/lib/schemas/item.schema.ts
new file mode 100644
index 000000000..050200826
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/item.schema.ts
@@ -0,0 +1,54 @@
+import { EntityContainerSchema, EntitySchema } from '@isa/common/data-access';
+import { z } from 'zod';
+import { CategorySchema } from './category.schema';
+import { CompanySchema } from './company.schema';
+import { ComponentsSchema } from './components.schema';
+import { ContributorHelperSchema } from './contributor-helper.schema';
+import { FileSchema } from './file.schema';
+import { FoodSchema } from './food.schema';
+import { ItemLabelSchema } from './item-label.schema';
+import { ItemTypeSchema } from './item-type.schema';
+import { SizeSchema } from './size.schema';
+import { TenantSchema } from './tenant.schema';
+import { TextSchema } from './text.schema';
+import { WeightSchema } from './weight.schema';
+
+export const ItemSchema = z
+  .object({
+    itemNumber: z.string().describe('Unique item number identifier').optional(),
+    name: z.string().describe('Item name').optional(),
+    subtitle: z.string().describe('Item subtitle').optional(),
+    description: z.string().describe('Item description text').optional(),
+    ean: z.string().describe('European Article Number barcode').optional(),
+    secondaryEAN: z.string().describe('Secondary EAN barcode').optional(),
+    precedingItem: EntityContainerSchema(
+      z.lazy((): z.ZodType<any> => ItemSchema),
+    ).describe('Reference to preceding item version').optional(),
+    precedingItemEAN: z.string().describe('EAN of preceding item version').optional(),
+    contributors: z.array(ContributorHelperSchema).describe('List of contributors (authors, editors, etc)').optional(),
+    manufacturer: EntityContainerSchema(CompanySchema).describe('Manufacturer company information').optional(),
+    publicationDate: z.string().describe('Publication date of the item').optional(),
+    categories: z.array(EntityContainerSchema(CategorySchema)).describe('List of item categories').optional(),
+    manufacturingCosts: z.number().describe('Manufacturing costs').optional(),
+    size: SizeSchema.describe('Physical size dimensions').optional(),
+    weight: WeightSchema.describe('Total weight').optional(),
+    netWeight: WeightSchema.describe('Net weight excluding packaging').optional(),
+    weightOfPackaging: WeightSchema.describe('Weight of packaging only').optional(),
+    itemType: ItemTypeSchema.describe('Type classification of the item').optional(),
+    edition: z.string().describe('Edition information').optional(),
+    serial: z.string().describe('Serial number').optional(),
+    format: z.string().describe('Format code (e.g., HC, PB, EB)').optional(),
+    formatDetail: z.string().describe('Detailed format description').optional(),
+    volume: z.string().describe('Volume information').optional(),
+    toxins: z.string().describe('Toxin warnings or information').optional(),
+    files: z.array(EntityContainerSchema(FileSchema)).describe('List of associated files').optional(),
+    texts: z.array(EntityContainerSchema(TextSchema)).describe('List of associated text content').optional(),
+    set: EntityContainerSchema(ComponentsSchema).describe('Set components if item is a set').optional(),
+    accessories: EntityContainerSchema(ComponentsSchema).describe('Accessory components').optional(),
+    labels: z.array(ItemLabelSchema).describe('List of item labels').optional(),
+    food: FoodSchema.describe('Food-specific information if applicable').optional(),
+    tenant: EntityContainerSchema(TenantSchema).describe('Tenant identifier').optional(),
+  })
+  .extend(EntitySchema.shape);
+
+export type Item = z.infer<typeof ItemSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/logistician.schema.ts b/libs/checkout/data-access/src/lib/schemas/logistician.schema.ts
new file mode 100644
index 000000000..81f19d49f
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/logistician.schema.ts
@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { EntitySchema } from '@isa/common/data-access';
+
+export const LogisticianSchema = z
+  .object({
+    gln: z.string().describe('Gln').optional(),
+    logisticianNumber: z.string().describe('Logistician number').optional(),
+    name: z.string().describe('Name').optional(),
+  })
+  .extend(EntitySchema.shape);
+
+export type Logistician = z.infer<typeof LogisticianSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/loyalty.schema.ts b/libs/checkout/data-access/src/lib/schemas/loyalty.schema.ts
new file mode 100644
index 000000000..af70be3ff
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/loyalty.schema.ts
@@ -0,0 +1,11 @@
+import { TouchBaseSchema } from '@isa/common/data-access';
+import { z } from 'zod';
+
+export const LoyaltySchema = z
+  .object({
+    code: z.string().describe('Code value').optional(),
+    label: z.string().describe('Label').optional(),
+    type: z.string().describe('Type').optional(),
+    value: z.number().describe('Value').optional(),
+  })
+  .extend(TouchBaseSchema.shape);
diff --git a/libs/checkout/data-access/src/lib/schemas/notification-channel.schema.ts b/libs/checkout/data-access/src/lib/schemas/notification-channel.schema.ts
new file mode 100644
index 000000000..1d923b60b
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/notification-channel.schema.ts
@@ -0,0 +1,11 @@
+/**
+ * @deprecated This schema has been moved to @isa/common/data-access.
+ * Please update imports to use:
+ * import { NotificationChannelSchema, NotificationChannel } from '@isa/common/data-access';
+ *
+ * This re-export will be removed in a future version.
+ */
+export {
+  NotificationChannelSchema,
+  NotificationChannel,
+} from '@isa/common/data-access';
diff --git a/libs/checkout/data-access/src/lib/schemas/nutrition-fact-type.schema.ts b/libs/checkout/data-access/src/lib/schemas/nutrition-fact-type.schema.ts
new file mode 100644
index 000000000..bad5a5e17
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/nutrition-fact-type.schema.ts
@@ -0,0 +1,69 @@
+import { z } from 'zod';
+
+export const NutritionFactType = {
+  NotSet: 0,
+  Energy: 1,
+  Protein: 2,
+  VegetableProtein: 6,
+  AnimalProtein: 10,
+  Fat: 16,
+  FatSaturated: 48,
+  FatMonoUnsaturated: 80,
+  FatPolyUnsaturated: 144,
+  TransFat: 272,
+  Cholesterol: 512,
+  Carbohydrate: 1024,
+  Sugar: 3072,
+  Fiber: 5120,
+  Starch: 9216,
+  Alcohol: 17408,
+  Sodium: 32768,
+  QuantityElements: 65536,
+  Calcium: 196608,
+  Chlorine: 327680,
+  Potassium: 589824,
+  Magnesium: 1114112,
+  Natrium: 2162688,
+  Phosphor: 4259840,
+  Sulfur: 8454144,
+  Hydrogencarbonate: 16842752,
+  Sulfate: 33619968,
+  Nitrate: 67174400,
+  Fluorid: 134283264,
+  Vitamins: 268435456,
+  VitaminA: 805306368,
+  VitaminB: 1342177280,
+  VitaminB1: 3489660928,
+  VitaminB2: 5637144576,
+  VitaminB3: 9932111872,
+  VitaminB5: 18522046464,
+  VitaminB6: 35701915648,
+  VitaminB7: 70061654016,
+  VitaminB9: 138781130752,
+  VitaminB12: 276220084224,
+  VitaminC: 550024249344,
+  VitaminD: 1099780063232,
+  VitaminE: 2199291691008,
+  VitaminK: 4398314946560,
+  TraceElements: 8796093022208,
+  Arsic: 26388279066624,
+  Boron: 43980465111040,
+  Chromium: 79164837199872,
+  Rubidium: 149533581377536,
+  Tin: 290271069732864,
+  Cobalt: 571746046443520,
+  Iron: 1134695999864832,
+  Fluorine: 2260595906707456,
+  Iodinde: 4512395720392704,
+  Copper: 9015995347763200,
+  Manganese: 18023194602504192,
+  Molybdenum: 36037593111986176,
+  Selenium: 72066390130950144,
+  Silicon: 144123984168878080,
+  Zinc: 288239172244733952,
+  Vanadium: 576469548396445696,
+} as const;
+
+export const NutritionFactTypeSchema = z.nativeEnum(NutritionFactType).describe('NutritionFact type');
+
+export type NutritionFactType = z.infer<typeof NutritionFactTypeSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/nutrition-fact.schema.ts b/libs/checkout/data-access/src/lib/schemas/nutrition-fact.schema.ts
new file mode 100644
index 000000000..b48025048
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/nutrition-fact.schema.ts
@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { TouchBaseSchema } from '@isa/common/data-access';
+import { NutritionFactTypeSchema } from './nutrition-fact-type.schema';
+
+export const NutritionFactSchema = TouchBaseSchema.extend({
+  label: z.string().describe('Label').optional(),
+  nutritionFactType: NutritionFactTypeSchema.describe('Nutrition fact type').optional(),
+  rdaQuantity: z.number().describe('Rda quantity').optional(),
+  percentageOfRDA: z.number().describe('Percentage of r d a').optional(),
+  kiloJoule: z.number().describe('Kilo joule').optional(),
+  quantity: z.number().describe('Quantity').optional(),
+});
+
+export type NutritionFact = z.infer<typeof NutritionFactSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/nutrition-facts.schema.ts b/libs/checkout/data-access/src/lib/schemas/nutrition-facts.schema.ts
new file mode 100644
index 000000000..c0a6c30e5
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/nutrition-facts.schema.ts
@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { TouchBaseSchema } from '@isa/common/data-access';
+import { RezeptmaszSchema } from './rezeptmasz.schema';
+import { NutritionFactSchema } from './nutrition-fact.schema';
+
+export const NutritionFactsSchema = TouchBaseSchema.extend({
+  referenceQuantity: z.number().describe('Reference quantity').optional(),
+  referenceQuantityUnitType: RezeptmaszSchema.describe('ReferenceQuantityUnit type').optional(),
+  kiloJoule: z.number().describe('Kilo joule').optional(),
+  kiloCalories: z.number().describe('Kilo calories').optional(),
+  items: z.array(NutritionFactSchema).describe('List of items').optional(),
+});
+
+export type NutritionFacts = z.infer<typeof NutritionFactsSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/payer-status.schema.ts b/libs/checkout/data-access/src/lib/schemas/payer-status.schema.ts
new file mode 100644
index 000000000..62afd9096
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/payer-status.schema.ts
@@ -0,0 +1,14 @@
+import { z } from 'zod';
+
+export const PayerStatus = {
+  NotSet: 0,
+  Blocked: 1,
+  Check: 2,
+  LowDegreeOfCreditworthiness: 4,
+  Dunning1: 8,
+  Dunning2: 16,
+} as const;
+
+export const PayerStatusSchema = z.nativeEnum(PayerStatus).describe('Payer status');
+
+export type PayerStatus = z.infer<typeof PayerStatusSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/payer-type.schema.ts b/libs/checkout/data-access/src/lib/schemas/payer-type.schema.ts
new file mode 100644
index 000000000..cd5e30e3d
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/payer-type.schema.ts
@@ -0,0 +1,12 @@
+import { z } from 'zod';
+
+export const PayerType = {
+  NotSet: 0,
+  Staff: 4,
+  B2C: 8,
+  B2B: 16,
+} as const;
+
+export const PayerTypeSchema = z.nativeEnum(PayerType).describe('Payer type');
+
+export type PayerType = z.infer<typeof PayerTypeSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/payer.schema.ts b/libs/checkout/data-access/src/lib/schemas/payer.schema.ts
new file mode 100644
index 000000000..ab63aa23d
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/payer.schema.ts
@@ -0,0 +1,14 @@
+import { AddresseeWithReferenceSchema } from '@isa/common/data-access';
+import { z } from 'zod';
+import { PayerStatusSchema } from './payer-status.schema';
+import { PayerTypeSchema } from './payer-type.schema';
+
+export const PayerSchema = z
+  .object({
+    payerNumber: z.string().describe('Unique payer account number').optional(),
+    payerType: PayerTypeSchema.describe('Payer type').optional(),
+    payerStatus: PayerStatusSchema.describe('Current status of the payer account').optional(),
+  })
+  .extend(AddresseeWithReferenceSchema.shape);
+
+export type Payer = z.infer<typeof PayerSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/payment-type.schema.ts b/libs/checkout/data-access/src/lib/schemas/payment-type.schema.ts
new file mode 100644
index 000000000..03d3a6806
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/payment-type.schema.ts
@@ -0,0 +1,8 @@
+/**
+ * @deprecated This schema has been moved to @isa/common/data-access.
+ * Please update imports to use:
+ * import { PaymentTypeSchema, PaymentType } from '@isa/common/data-access';
+ *
+ * This re-export will be removed in a future version.
+ */
+export { PaymentTypeSchema, PaymentType } from '@isa/common/data-access';
diff --git a/libs/checkout/data-access/src/lib/schemas/price-flat.schema.ts b/libs/checkout/data-access/src/lib/schemas/price-flat.schema.ts
new file mode 100644
index 000000000..f0d8166c3
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/price-flat.schema.ts
@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { VatTypeSchema } from '@isa/common/data-access';
+
+// Schema for the flat Price type (not PriceDTO)
+// This matches the Price interface from generated/swagger/checkout-api/src/models/price.ts
+export const PriceFlatSchema = z.object({
+  currency: z.string().describe('Currency code').optional(),
+  currencySymbol: z.string().describe('Currency symbol').optional(),
+  validFrom: z.string().describe('Validity start date').optional(),
+  value: z.number().describe('Value'),
+  vatInPercent: z.number().describe('Vat in percent').optional(),
+  vatType: VatTypeSchema.describe('VAT type'),
+  vatValue: z.number().describe('VAT amount value').optional(),
+});
+
+export type PriceFlat = z.infer<typeof PriceFlatSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/product.schema.ts b/libs/checkout/data-access/src/lib/schemas/product.schema.ts
new file mode 100644
index 000000000..50eaa9f35
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/product.schema.ts
@@ -0,0 +1,27 @@
+import { TouchBaseSchema } from '@isa/common/data-access';
+import { z } from 'zod';
+import { SizeSchema } from './size.schema';
+import { WeightSchema } from './weight.schema';
+
+export const ProductSchema = z
+  .object({
+    additionalName: z.string().describe('Additional name').optional(),
+    catalogProductNumber: z.string().describe('CatalogProduct number').optional(),
+    contributors: z.string().describe('Contributors').optional(),
+    ean: z.string().describe('European Article Number barcode').optional(),
+    edition: z.string().describe('Edition').optional(),
+    format: z.string().describe('Format').optional(),
+    formatDetail: z.string().describe('Format detail').optional(),
+    locale: z.string().describe('Locale').optional(),
+    manufacturer: z.string().describe('Manufacturer information').optional(),
+    name: z.string().describe('Name').optional(),
+    productGroup: z.string().describe('Product group').optional(),
+    productGroupDetails: z.string().describe('Product group details').optional(),
+    publicationDate: z.string().describe('Publication date').optional(),
+    serial: z.string().describe('Serial').optional(),
+    size: SizeSchema.describe('Size').optional(),
+    supplierProductNumber: z.string().describe('SupplierProduct number').optional(),
+    volume: z.string().describe('Volume').optional(),
+    weight: WeightSchema.describe('Weight').optional(),
+  })
+  .extend(TouchBaseSchema.shape);
diff --git a/libs/checkout/data-access/src/lib/schemas/promotion.schema.ts b/libs/checkout/data-access/src/lib/schemas/promotion.schema.ts
new file mode 100644
index 000000000..bb217184e
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/promotion.schema.ts
@@ -0,0 +1,11 @@
+import { TouchBaseSchema } from '@isa/common/data-access';
+import { z } from 'zod';
+
+export const PromotionSchema = z
+  .object({
+    code: z.string().describe('Code value').optional(),
+    label: z.string().describe('Label').optional(),
+    type: z.string().describe('Type').optional(),
+    value: z.number().describe('Value').optional(),
+  })
+  .extend(TouchBaseSchema.shape);
diff --git a/libs/checkout/data-access/src/lib/schemas/quantity-unit-type.schema.ts b/libs/checkout/data-access/src/lib/schemas/quantity-unit-type.schema.ts
new file mode 100644
index 000000000..5cb91ec22
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/quantity-unit-type.schema.ts
@@ -0,0 +1,11 @@
+/**
+ * @deprecated This schema has been moved to @isa/common/data-access.
+ * Please update imports to use:
+ * import { QuantityUnitTypeSchema, QuantityUnitType } from '@isa/common/data-access';
+ *
+ * This re-export will be removed in a future version.
+ */
+export {
+  QuantityUnitTypeSchema,
+  QuantityUnitType,
+} from '@isa/common/data-access';
diff --git a/libs/checkout/data-access/src/lib/schemas/remove-shopping-cart-item-params.schema.ts b/libs/checkout/data-access/src/lib/schemas/remove-shopping-cart-item-params.schema.ts
index 4017646d1..07ea5915f 100644
--- a/libs/checkout/data-access/src/lib/schemas/remove-shopping-cart-item-params.schema.ts
+++ b/libs/checkout/data-access/src/lib/schemas/remove-shopping-cart-item-params.schema.ts
@@ -1,8 +1,8 @@
 import { z } from 'zod';
 
 export const RemoveShoppingCartItemParamsSchema = z.object({
-  shoppingCartId: z.number().int().positive(),
-  shoppingCartItemId: z.number().int().positive(),
+  shoppingCartId: z.number().int().positive().describe('Shopping cart identifier'),
+  shoppingCartItemId: z.number().int().positive().describe('Shopping cart item identifier'),
 });
 
 export type RemoveShoppingCartItemParams = z.infer<
diff --git a/libs/checkout/data-access/src/lib/schemas/rezeptmasz.schema.ts b/libs/checkout/data-access/src/lib/schemas/rezeptmasz.schema.ts
new file mode 100644
index 000000000..66c219291
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/rezeptmasz.schema.ts
@@ -0,0 +1,40 @@
+import { z } from 'zod';
+
+export const Rezeptmasz = {
+  NotSet: 0,
+  Mikrogram: 1,
+  Milligram: 2,
+  Gram: 3,
+  Dekagramm: 4,
+  Lot: 5,
+  Kilogram: 6,
+  Pfund: 7,
+  Grain: 8,
+  Ounce: 9,
+  Pound: 10,
+  Milliliter: 11,
+  Centiliter: 12,
+  FluidOunce: 13,
+  Deciliter: 14,
+  Liter: 15,
+  Mass: 16,
+  Pint: 17,
+  Quart: 18,
+  Gallon: 19,
+  Drop: 20,
+  Dash: 21,
+  Schuss: 22,
+  Pinch: 23,
+  Messerspitze: 24,
+  Saitspoon: 25,
+  Teaspoon: 26,
+  Tablespoon: 27,
+  Tasse: 28,
+  Cup: 29,
+  Bund: 30,
+  Slice: 31,
+} as const;
+
+export const RezeptmaszSchema = z.nativeEnum(Rezeptmasz).describe('Rezeptmasz');
+
+export type Rezeptmasz = z.infer<typeof RezeptmaszSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/set-type.schema.ts b/libs/checkout/data-access/src/lib/schemas/set-type.schema.ts
new file mode 100644
index 000000000..651701f9b
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/set-type.schema.ts
@@ -0,0 +1,11 @@
+import { z } from 'zod';
+
+export const SetType = {
+  NotSet: 0,
+  Fixed: 1,
+  Choice: 2,
+} as const;
+
+export const SetTypeSchema = z.nativeEnum(SetType).describe('Set type');
+
+export type SetType = z.infer<typeof SetTypeSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/shipping-address.schema.ts b/libs/checkout/data-access/src/lib/schemas/shipping-address.schema.ts
index 9ffaa4e9b..282c6f901 100644
--- a/libs/checkout/data-access/src/lib/schemas/shipping-address.schema.ts
+++ b/libs/checkout/data-access/src/lib/schemas/shipping-address.schema.ts
@@ -1,2 +1,3 @@
 import { AddresseeWithReferenceSchema } from '@isa/common/data-access';
+
 export const ShippingAddressSchema = AddresseeWithReferenceSchema.extend({});
diff --git a/libs/checkout/data-access/src/lib/schemas/shipping-target.schema.ts b/libs/checkout/data-access/src/lib/schemas/shipping-target.schema.ts
new file mode 100644
index 000000000..3966ffda8
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/shipping-target.schema.ts
@@ -0,0 +1,4 @@
+import { z } from 'zod';
+import { ShippingTarget } from '../models';
+
+export const ShippingTargetSchema = z.nativeEnum(ShippingTarget).optional().describe('Shipping target');
diff --git a/libs/checkout/data-access/src/lib/schemas/shop-item.schema.ts b/libs/checkout/data-access/src/lib/schemas/shop-item.schema.ts
new file mode 100644
index 000000000..b277da7ba
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/shop-item.schema.ts
@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { AvailabilitySchema } from './availability.schema';
+import { UrlSchema } from './url.schema';
+import { ImageSchema } from './image.schema';
+import { EntityContainerSchema } from '@isa/common/data-access';
+
+export const ShopItemSchema = z.object({
+  availability: AvailabilitySchema.describe('Availability').optional(),
+  deepUrl: UrlSchema.describe('Deep url').optional(),
+  description: z.string().describe('Description text').optional(),
+  ean: z.string().describe('European Article Number barcode').optional(),
+  firstDayOfSale: z.string().describe('First day of sale').optional(),
+  format: z.string().describe('Format').optional(),
+  image: ImageSchema.describe('Image').optional(),
+  item: EntityContainerSchema(z.any()).describe('Item').optional(),
+});
+
+export type ShopItem = z.infer<typeof ShopItemSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/size.schema.ts b/libs/checkout/data-access/src/lib/schemas/size.schema.ts
new file mode 100644
index 000000000..3022b2081
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/size.schema.ts
@@ -0,0 +1,10 @@
+import { z } from 'zod';
+
+export const SizeSchema = z.object({
+  height: z.number().describe('Height'),
+  width: z.number().describe('Width'),
+  length: z.number().describe('Length'),
+  unit: z.string().describe('Unit').optional(),
+});
+
+export type Size = z.infer<typeof SizeSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/supplier-type.schema.ts b/libs/checkout/data-access/src/lib/schemas/supplier-type.schema.ts
new file mode 100644
index 000000000..0db782341
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/supplier-type.schema.ts
@@ -0,0 +1,12 @@
+import { z } from 'zod';
+
+export const SupplierType = {
+  NotSet: 0,
+  Publisher: 1,
+  Wholesaler: 2,
+  Distributor: 4,
+} as const;
+
+export const SupplierTypeSchema = z.nativeEnum(SupplierType).describe('Supplier type');
+
+export type SupplierType = z.infer<typeof SupplierTypeSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/supplier.schema.ts b/libs/checkout/data-access/src/lib/schemas/supplier.schema.ts
new file mode 100644
index 000000000..ae0ddcac3
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/supplier.schema.ts
@@ -0,0 +1,14 @@
+import { EntitySchema } from '@isa/common/data-access';
+import { z } from 'zod';
+import { SupplierTypeSchema } from './supplier-type.schema';
+
+export const SupplierSchema = z
+  .object({
+    key: z.string().describe('Key').optional(),
+    name: z.string().describe('Name').optional(),
+    supplierNumber: z.string().describe('Supplier number').optional(),
+    supplierType: SupplierTypeSchema.describe('Supplier type').optional(),
+  })
+  .extend(EntitySchema.shape);
+
+export type Supplier = z.infer<typeof SupplierSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/tenant.schema.ts b/libs/checkout/data-access/src/lib/schemas/tenant.schema.ts
new file mode 100644
index 000000000..16fc3f4a0
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/tenant.schema.ts
@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { EntitySchema } from '@isa/common/data-access';
+
+export const TenantSchema = EntitySchema.extend({
+  name: z.string().describe('Name').optional(),
+  key: z.string().describe('Key').optional(),
+});
+
+export type Tenant = z.infer<typeof TenantSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/text.schema.ts b/libs/checkout/data-access/src/lib/schemas/text.schema.ts
new file mode 100644
index 000000000..efeff7ea4
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/text.schema.ts
@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { EntitySchema, EntityContainerSchema } from '@isa/common/data-access';
+
+export const TextSchema = EntitySchema.extend({
+  cultureInfo: z.string().describe('Culture info').optional(),
+  name: z.string().describe('Name').optional(),
+  subtitle: z.string().describe('Subtitle').optional(),
+  copyright: z.string().describe('Copyright').optional(),
+  type: z.string().describe('Type').optional(),
+  content: z.string().describe('Content').optional(),
+  encoding: z.string().describe('Encoding').optional(),
+  mime: z.string().describe('Mime').optional(),
+  hash: z.string().describe('Whether has h').optional(),
+  tenant: EntityContainerSchema(z.any()).describe('Tenant identifier').optional(),
+});
+
+export type Text = z.infer<typeof TextSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/update-shopping-cart-item-params.schema.ts b/libs/checkout/data-access/src/lib/schemas/update-shopping-cart-item-params.schema.ts
index 4f57f531f..23ae07f5b 100644
--- a/libs/checkout/data-access/src/lib/schemas/update-shopping-cart-item-params.schema.ts
+++ b/libs/checkout/data-access/src/lib/schemas/update-shopping-cart-item-params.schema.ts
@@ -1,24 +1,26 @@
 import { z } from 'zod';
-import {
-  AvailabilityDTOSchema,
-  CampaignDTOSchema,
-  LoyaltyDTOSchema,
-  PromotionDTOSchema,
-  PriceSchema,
-  EntityDTOContainerOfDestinationDTOSchema,
-} from './base-schemas';
 import { UpdateShoppingCartItem } from '../models';
+import { EntityContainerSchema, PriceSchema } from '@isa/common/data-access';
+import { AvailabilitySchema } from './availability.schema';
+import { CampaignSchema } from './campaign.schema';
+import { DestinationSchema } from './destination.schema';
+import { LoyaltySchema } from './loyalty.schema';
+import { PromotionSchema } from './promotion.schema';
 
 const UpdateShoppingCartItemParamsValueDefaultSchema = z.object({
-  availability: AvailabilityDTOSchema,
-  buyerComment: z.string().optional(),
-  campaign: CampaignDTOSchema,
-  destination: EntityDTOContainerOfDestinationDTOSchema,
-  loyalty: LoyaltyDTOSchema,
-  promotion: PromotionDTOSchema,
-  quantity: z.number().int().positive().optional(),
-  retailPrice: PriceSchema,
-  specialComment: z.string().optional(),
+  availability: AvailabilitySchema.describe(
+    'Availability information',
+  ).optional(),
+  buyerComment: z.string().describe('Buyer comment text').optional(),
+  campaign: CampaignSchema.describe('Campaign information').optional(),
+  destination: EntityContainerSchema(DestinationSchema)
+    .optional()
+    .describe('Destination information'),
+  loyalty: LoyaltySchema.describe('Loyalty information').optional(),
+  promotion: PromotionSchema.describe('Promotion information').optional(),
+  quantity: z.number().int().positive().describe('Item quantity').optional(),
+  retailPrice: PriceSchema.describe('Retail price').optional(),
+  specialComment: z.string().describe('Special comment text').optional(),
 });
 
 // When loyalty points are used the price value must be 0 and promotion is not allowed
@@ -29,30 +31,48 @@ const UpdateShoppingCartItemParamsValueWithRedemptionPointsSchema =
     availability: true,
     promotion: true,
   }).extend({
-    availability: AvailabilityDTOSchema.unwrap()
-      .omit({ price: true })
+    availability: AvailabilitySchema.omit({ price: true })
       .extend({
-        price: PriceSchema.unwrap()
-          .omit({ value: true })
+        price: PriceSchema.omit({ value: true })
           .extend({
-            value: z.object({
-              value: z.literal(0),
-              currency: z.string(),
-            }),
-          }),
-      }),
-    loyalty: LoyaltyDTOSchema,
+            value: z
+              .object({
+                value: z
+                  .literal(0)
+                  .describe('Price value must be 0 for loyalty redemption'),
+                currency: z.string().describe('Currency code'),
+              })
+              .describe('Price value object'),
+          })
+          .describe('Price information for loyalty redemption'),
+      })
+      .describe('Availability information for loyalty redemption'),
+    loyalty: LoyaltySchema.describe(
+      'Loyalty information for points redemption',
+    ),
   });
 
-const UpdateShoppingCartItemParamsValueSchema = z.union([
-  UpdateShoppingCartItemParamsValueDefaultSchema,
-  UpdateShoppingCartItemParamsValueWithRedemptionPointsSchema,
-]);
+const UpdateShoppingCartItemParamsValueSchema = z
+  .union([
+    UpdateShoppingCartItemParamsValueDefaultSchema,
+    UpdateShoppingCartItemParamsValueWithRedemptionPointsSchema,
+  ])
+  .describe('Update shopping cart item params value');
 
 export const UpdateShoppingCartItemParamsSchema = z.object({
-  shoppingCartId: z.number().int().positive(),
-  shoppingCartItemId: z.number().int().positive(),
-  values: UpdateShoppingCartItemParamsValueSchema,
+  shoppingCartId: z
+    .number()
+    .int()
+    .positive()
+    .describe('Shopping cart identifier'),
+  shoppingCartItemId: z
+    .number()
+    .int()
+    .positive()
+    .describe('Shopping cart item identifier'),
+  values: UpdateShoppingCartItemParamsValueSchema.describe(
+    'Updated values for the cart item',
+  ),
 });
 
 export type UpdateShoppingCartItemParams = {
diff --git a/libs/checkout/data-access/src/lib/schemas/url.schema.ts b/libs/checkout/data-access/src/lib/schemas/url.schema.ts
new file mode 100644
index 000000000..be638f7a7
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/url.schema.ts
@@ -0,0 +1,13 @@
+import { TouchBaseSchema } from '@isa/common/data-access';
+import { z } from 'zod';
+
+export const UrlSchema = z
+  .object({
+    nofollow: z.boolean().describe('Nofollow').optional(),
+    target: z.string().describe('Target').optional(),
+    title: z.string().describe('Title').optional(),
+    url: z.string().describe('URL address').optional(),
+  })
+  .extend(TouchBaseSchema.shape);
+
+export type Url = z.infer<typeof UrlSchema>;
diff --git a/libs/checkout/data-access/src/lib/schemas/weight.schema.ts b/libs/checkout/data-access/src/lib/schemas/weight.schema.ts
new file mode 100644
index 000000000..9ed897fd6
--- /dev/null
+++ b/libs/checkout/data-access/src/lib/schemas/weight.schema.ts
@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { AvoirdupoisSchema } from './avoirdupois.schema';
+
+export const WeightSchema = z.object({
+  value: z.number().describe('Value'),
+  unit: AvoirdupoisSchema.describe('Unit'),
+});
+
+export type Weight = z.infer<typeof WeightSchema>;
diff --git a/libs/checkout/data-access/src/lib/services/branch.service.ts b/libs/checkout/data-access/src/lib/services/branch.service.ts
index bca9af65a..3a183a153 100644
--- a/libs/checkout/data-access/src/lib/services/branch.service.ts
+++ b/libs/checkout/data-access/src/lib/services/branch.service.ts
@@ -4,7 +4,7 @@ import { ResponseArgsError, takeUntilAborted } from '@isa/common/data-access';
 import { logger } from '@isa/core/logging';
 import { firstValueFrom } from 'rxjs';
 import { Cache, CacheTimeToLive, InFlight } from '@isa/common/decorators';
-import { Branch } from '../models';
+import { Branch } from '../schemas';
 
 @Injectable({ providedIn: 'root' })
 export class BranchService {
diff --git a/libs/checkout/data-access/src/lib/services/checkout.service.ts b/libs/checkout/data-access/src/lib/services/checkout.service.ts
index 9212f1908..4b820e698 100644
--- a/libs/checkout/data-access/src/lib/services/checkout.service.ts
+++ b/libs/checkout/data-access/src/lib/services/checkout.service.ts
@@ -6,32 +6,38 @@ import {
   StoreCheckoutBuyerService,
   StoreCheckoutPayerService,
   StoreCheckoutPaymentService,
+  DestinationDTO,
   BuyerDTO,
   PayerDTO,
-  ShippingAddressDTO,
-  NotificationChannel,
-  PaymentType,
-  DestinationDTO,
-  EntityDTOContainerOfShoppingCartItemDTO,
+  AvailabilityDTO,
 } from '@generated/swagger/checkout-api';
-import { ResponseArgsError, takeUntilAborted } from '@isa/common/data-access';
+
+import {
+  EntityContainer,
+  ResponseArgsError,
+  takeUntilAborted,
+} from '@isa/common/data-access';
 import { logger } from '@isa/core/logging';
 import { firstValueFrom } from 'rxjs';
 import { ShoppingCartService } from './shopping-cart.service';
 import {
-  CompleteCheckoutParams,
-  CompleteCheckoutParamsSchema,
+  Buyer,
+  CompleteOrderParams,
+  CompleteOrderParamsSchema,
+  NotificationChannel,
+  Payer,
+  PaymentType,
 } from '../schemas';
 import {
   Order,
   OrderOptionsAnalysis,
   CustomerTypeAnalysis,
   Checkout,
-  ShoppingCartItem,
   ShippingAddress,
+  ShoppingCartItem,
 } from '../models';
 import { CheckoutCompletionError } from '../errors';
-import { OrderCreationService } from '@isa/oms/data-access';
+import { LogisticianService } from '@isa/oms/data-access';
 import { AvailabilityService } from '@isa/catalogue/data-access';
 import { BranchService } from '@isa/remission/data-access';
 import {
@@ -47,12 +53,10 @@ import {
   shouldSetPayer,
   needsDestinationUpdate,
   determinePaymentType,
-  PaymentTypes,
   filterShippingItems,
   filterDeliveryDestinations,
   hasValidItemId,
   hasValidDestinationData,
-  ShippingTargets,
 } from '../helpers';
 
 /**
@@ -82,22 +86,26 @@ export class CheckoutService {
 
   // Domain data-access services
   #shoppingCartDataService = inject(ShoppingCartService);
-  #orderCreationService = inject(OrderCreationService);
+  #logisticianService = inject(LogisticianService);
   #availabilityService = inject(AvailabilityService);
   #branchService = inject(BranchService);
 
   /**
-   * Completes the checkout process, creating orders.
+   * Completes the checkout process.
    *
    * @param params - Complete checkout parameters with all required data
    * @param abortSignal - Optional cancellation signal
-   * @returns Promise resolving to an array of created orders
+   * @returns Promise resolving to the completed checkout ID
    * @throws {CheckoutCompletionError} for business logic failures
    * @throws {ResponseArgsError} for API failures
    *
+   * @remarks
+   * This method prepares the checkout but does NOT create orders.
+   * Order creation should be handled separately by calling order creation services.
+   *
    * @example
    * ```typescript
-   * const orders = await checkoutService.complete({
+   * const checkoutId = await checkoutService.complete({
    *   checkoutId: 123,
    *   shoppingCartId: 456,
    *   buyer: buyerDTO,
@@ -110,10 +118,10 @@ export class CheckoutService {
    * ```
    */
   async complete(
-    params: CompleteCheckoutParams,
+    params: CompleteOrderParams,
     abortSignal?: AbortSignal,
-  ): Promise<Order[]> {
-    const validated = CompleteCheckoutParamsSchema.parse(params);
+  ): Promise<number> {
+    const validated = CompleteOrderParamsSchema.parse(params);
 
     this.#logger.info('Starting checkout completion');
 
@@ -213,7 +221,7 @@ export class CheckoutService {
       this.#logger.debug('Setting notification channels');
       await this.setNotificationChannelsOnCheckout(
         checkoutId,
-        validated.notificationChannels,
+        validated.notificationChannels ?? 0,
         abortSignal,
       );
 
@@ -246,14 +254,12 @@ export class CheckoutService {
         );
       }
 
-      // Step 14: Create order(s)
-      this.#logger.debug('Creating orders');
-      const orders =
-        await this.#orderCreationService.createOrdersFromCheckout(checkoutId);
+      // Checkout completion is done - return checkoutId for order creation
+      this.#logger.info('Checkout completed successfully', () => ({
+        checkoutId,
+      }));
 
-      this.#logger.info('Checkout completed successfully');
-
-      return orders;
+      return checkoutId;
     } catch (error) {
       // Handle HTTP 409 conflict (order already exists)
       if (error instanceof HttpErrorResponse && error.status === 409) {
@@ -274,7 +280,7 @@ export class CheckoutService {
    * Analyzes shopping cart items to determine which order types are present.
    */
   private analyzeOrderOptions(
-    items: EntityDTOContainerOfShoppingCartItemDTO[],
+    items: EntityContainer<ShoppingCartItem>[],
   ): OrderOptionsAnalysis {
     return analyzeOrderOptions(items);
   }
@@ -352,7 +358,7 @@ export class CheckoutService {
    */
   private async setSpecialCommentOnItems(
     shoppingCartId: number,
-    items: EntityDTOContainerOfShoppingCartItemDTO[],
+    items: EntityContainer<ShoppingCartItem>[],
     comment: string,
     abortSignal?: AbortSignal,
   ): Promise<void> {
@@ -417,7 +423,7 @@ export class CheckoutService {
    */
   private async validateDownloadAvailabilities(
     shoppingCartId: number,
-    items: EntityDTOContainerOfShoppingCartItemDTO[],
+    items: EntityContainer<ShoppingCartItem>[],
     abortSignal?: AbortSignal,
   ): Promise<void> {
     // Convert checkout-api items to catalogue-api format using adapter
@@ -478,7 +484,7 @@ export class CheckoutService {
    */
   private async updateShippingAvailabilities(
     shoppingCartId: number,
-    items: EntityDTOContainerOfShoppingCartItemDTO[],
+    items: EntityContainer<ShoppingCartItem>[],
     abortSignal?: AbortSignal,
   ): Promise<void> {
     // Filter shipping items
@@ -489,7 +495,7 @@ export class CheckoutService {
     // Get branch and logistician in parallel
     const [inventoryBranch, omsLogistician] = await Promise.all([
       this.#branchService.getDefaultBranch(abortSignal),
-      this.#orderCreationService.getLogistician('2470', abortSignal),
+      this.#logisticianService.getLogistician2470(abortSignal),
     ]);
 
     // Convert to catalogue format using adapters
@@ -566,12 +572,12 @@ export class CheckoutService {
    */
   private async setBuyerOnCheckout(
     checkoutId: number,
-    buyer: BuyerDTO,
+    buyerDTO: Buyer,
     abortSignal?: AbortSignal,
   ): Promise<Checkout> {
     let req$ = this.#buyerService.StoreCheckoutBuyerSetBuyerPOST({
       checkoutId,
-      buyerDTO: buyer,
+      buyerDTO,
     });
 
     if (abortSignal) {
@@ -594,12 +600,12 @@ export class CheckoutService {
    */
   private async setPayerOnCheckout(
     checkoutId: number,
-    payer: PayerDTO,
+    payer: Payer,
     abortSignal?: AbortSignal,
   ): Promise<Checkout> {
     let req$ = this.#payerService.StoreCheckoutPayerSetPayerPOST({
       checkoutId,
-      payerDTO: payer as PayerDTO,
+      payerDTO: payer,
     });
 
     if (abortSignal) {
diff --git a/libs/checkout/data-access/src/lib/services/shopping-cart.service.ts b/libs/checkout/data-access/src/lib/services/shopping-cart.service.ts
index e981f4d5b..dd6d6cb5b 100644
--- a/libs/checkout/data-access/src/lib/services/shopping-cart.service.ts
+++ b/libs/checkout/data-access/src/lib/services/shopping-cart.service.ts
@@ -119,6 +119,7 @@ export class ShoppingCartService {
   async updateItem(
     params: UpdateShoppingCartItemParams,
   ): Promise<ShoppingCart> {
+    console.log('UpdateShoppingCartItemParams', params);
     const parsed = UpdateShoppingCartItemParamsSchema.parse(params);
 
     const req$ =
diff --git a/libs/checkout/data-access/src/lib/services/supplier.service.ts b/libs/checkout/data-access/src/lib/services/supplier.service.ts
index a383d1e0c..c2b2bcf8d 100644
--- a/libs/checkout/data-access/src/lib/services/supplier.service.ts
+++ b/libs/checkout/data-access/src/lib/services/supplier.service.ts
@@ -4,7 +4,7 @@ import { ResponseArgsError, takeUntilAborted } from '@isa/common/data-access';
 import { logger } from '@isa/core/logging';
 import { firstValueFrom } from 'rxjs';
 import { Cache, CacheTimeToLive, InFlight } from '@isa/common/decorators';
-import { Supplier } from '../models';
+import { Supplier } from '../schemas';
 
 /**
  * Service for fetching supplier information from the checkout API.
diff --git a/libs/checkout/feature/reward-catalog/README.md b/libs/checkout/feature/reward-catalog/README.md
index 506f5b8fb..67e038be5 100644
--- a/libs/checkout/feature/reward-catalog/README.md
+++ b/libs/checkout/feature/reward-catalog/README.md
@@ -1,7 +1,1747 @@
-# reward-catalog
+# @isa/checkout/feature/reward-catalog
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive loyalty rewards catalog feature for Angular applications supporting reward item browsing, selection, and checkout for customers with bonus cards.
 
-## Running unit tests
+## Overview
 
-Run `nx test reward-catalog` to execute the unit tests.
+The Reward Catalog feature library provides a complete user interface for browsing and selecting loyalty reward items. It integrates customer bonus card information, manages reward item selection state, handles filtering and pagination, and orchestrates the checkout flow for reward redemption. The library supports both customer-selected and guest workflows, with automatic navigation to customer selection when needed.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [Component API Reference](#component-api-reference)
+- [Usage Examples](#usage-examples)
+- [Routing and Navigation](#routing-and-navigation)
+- [Filtering and Search](#filtering-and-search)
+- [State Management](#state-management)
+- [Architecture Notes](#architecture-notes)
+- [Dependencies](#dependencies)
+- [Testing](#testing)
+- [Best Practices](#best-practices)
+
+## Features
+
+- **Customer Context Management** - Displays customer bonus card information and available points
+- **Reward Item Browsing** - Searchable, filterable catalog of loyalty reward items
+- **Multi-Select Interface** - Checkbox-based selection of multiple reward items
+- **Infinite Scroll Pagination** - Automatic loading of additional items on scroll
+- **Customer Selection Flow** - Automatic navigation to customer search for guest users
+- **Shopping Cart Integration** - Creates and manages reward-specific shopping carts
+- **Purchase Options Modal** - Launches purchase options dialog with redemption point calculation
+- **Responsive Design** - Tablet and desktop layouts with breakpoint-aware rendering
+- **Filter Persistence** - Query parameter synchronization for filter state
+- **Empty State Handling** - User-friendly messages and reset actions when no results found
+- **Loading States** - Skeleton loaders and spinners for async operations
+- **Tab Context Integration** - Reward context tracking for multi-tab workflows
+
+## Quick Start
+
+### 1. Route Configuration
+
+```typescript
+import { Routes } from '@angular/router';
+
+const routes: Routes = [
+  {
+    path: 'reward',
+    loadChildren: () =>
+      import('@isa/checkout/feature/reward-catalog').then(m => m.routes)
+  }
+];
+```
+
+### 2. Basic Usage
+
+The library is designed to be lazy-loaded as a route module:
+
+```typescript
+// In your app routing configuration
+{
+  path: 'kunde/:tabId/reward',
+  loadChildren: () =>
+    import('@isa/checkout/feature/reward-catalog').then(m => m.routes),
+  data: {
+    scrollPositionRestoration: true  // Automatically handled
+  }
+}
+```
+
+### 3. Navigation to Reward Catalog
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-feature',
+  template: '...'
+})
+export class FeatureComponent {
+  #router = inject(Router);
+  tabId = 123;
+
+  navigateToRewardCatalog(): void {
+    this.#router.navigate(['/kunde', this.tabId, 'reward']);
+  }
+}
+```
+
+## Core Concepts
+
+### Customer Workflows
+
+The library supports two primary user workflows:
+
+#### 1. Guest Workflow (No Customer Selected)
+
+When no customer is selected, the header displays a **RewardStartCard**:
+
+```typescript
+// User sees welcome message
+// CTA button: "Kund*in auswählen" (Select Customer)
+// Clicking navigates to customer search filtered for loyalty customers
+```
+
+#### 2. Customer Selected Workflow
+
+When a customer with a bonus card is selected, the header displays a **RewardCustomerCard**:
+
+```typescript
+// Displays: Customer name, available Lesepunkte (reading points)
+// Shows: Number of rewards selected in shopping cart
+// Actions:
+//   - "Zurücksetzen" (Reset) - Clears customer and cart
+//   - "Prämienausgabe" (Reward Checkout) - Navigates to checkout (when items selected)
+```
+
+### Reward Item Selection
+
+Items are selected using checkboxes with state managed by `RewardCatalogStore`:
+
+```typescript
+// Selection flow:
+1. User clicks checkbox on reward item
+2. Item added to RewardCatalogStore.selectedItems
+3. Selection state persists in session storage
+4. "Prämie auswählen" button becomes enabled
+5. User clicks button to open purchase options modal
+6. Items added to reward shopping cart
+7. Selection state cleared on successful addition
+```
+
+### Search and Filtering
+
+The library integrates with `@isa/shared/filter` for comprehensive filtering:
+
+```typescript
+// Filter capabilities:
+- Text search across item names and descriptions
+- Category filtering
+- Point value filtering
+- Sorting options (by points, name, etc.)
+- Filter state synced to URL query parameters
+- Filter persistence across page reloads
+```
+
+### Pagination Strategy
+
+Infinite scroll pagination using intersection observer:
+
+```typescript
+// Pagination flow:
+1. Initial load fetches first page (e.g., 20 items)
+2. User scrolls to bottom
+3. InViewportDirective detects trigger element
+4. searchTrigger set to 'reload'
+5. Next page fetched and appended to existing items
+6. Process repeats until all items loaded (itemsLength === hits)
+```
+
+## Component API Reference
+
+### RewardCatalogComponent
+
+Main container component that orchestrates the entire reward catalog feature.
+
+**Selector:** `reward-catalog`
+
+**Providers:**
+- `SelectedRewardShoppingCartResource` - Resource for fetching reward shopping cart
+- `SelectedCustomerBonusCardsResource` - Resource for fetching customer bonus cards
+- `provideFilter()` - Filter service configuration with query settings and URL sync
+
+**Methods:**
+
+#### `search(trigger: SearchTrigger): void`
+
+Triggers a search operation with the specified trigger type.
+
+**Parameters:**
+- `trigger: 'scan' | 'input' | 'filter' | 'orderBy'` - The search trigger type
+
+**Example:**
+```typescript
+// Called by filter-controls-panel
+search('filter');  // User changed a filter
+search('input');   // User typed in search box
+```
+
+#### `initRewardContext(): void`
+
+Initializes the reward context in tab metadata. Called automatically in constructor.
+
+**Purpose:** Marks the current tab as being in "reward" context, which is used by customer search to know the user's intent.
+
+**Example:**
+```typescript
+// Automatically called on component initialization
+// Sets: TabMetadata.context = 'reward'
+// Used by customer search to customize behavior
+```
+
+**Host Classes:**
+```css
+/* Applied classes */
+w-full flex flex-col gap-4 mt-5 isa-desktop:mt-6 overflow-x-hidden
+```
+
+---
+
+### RewardHeaderComponent
+
+Displays customer information or guest welcome message based on customer selection state.
+
+**Selector:** `reward-header`
+
+**Computed Signals:**
+
+#### `bonusCards: Signal<BonusCard[]>`
+
+All bonus cards for the selected customer.
+
+#### `primaryBonusCard: Signal<BonusCard | undefined>`
+
+The primary bonus card (used for point balance and customer name).
+
+**Template Logic:**
+
+```typescript
+// Conditional rendering based on customer state
+@if (!cardFetching) {
+  @if (card) {
+    <reward-customer-card></reward-customer-card>  // Customer selected
+  } @else {
+    <reward-start-card></reward-start-card>        // No customer
+  }
+} @else {
+  // Loading skeleton
+}
+```
+
+---
+
+### RewardCustomerCardComponent
+
+Displays selected customer information, available points, and checkout options.
+
+**Selector:** `reward-customer-card`
+
+**Computed Signals:**
+
+#### `bonusCards: Signal<BonusCard[]>`
+
+Array of bonus cards for the customer.
+
+#### `primaryBonusCard: Signal<BonusCard | undefined>`
+
+The primary bonus card with customer details.
+
+#### `primaryBonusCardPoints: Signal<number>`
+
+Available reading points (Lesepunkte) for redemption.
+
+**Default:** `0`
+
+#### `cartItemsLength: Signal<number>`
+
+Number of items currently in the reward shopping cart.
+
+**Methods:**
+
+#### `resetCustomerAndCart(): void`
+
+Clears the selected customer and reward shopping cart from tab metadata.
+
+**Effects:**
+- Removes customer selection
+- Clears reward shopping cart ID
+- Header switches to RewardStartCard
+- User must re-select customer
+
+**Example:**
+```typescript
+// Called when user clicks "Zurücksetzen" button
+resetCustomerAndCart();
+// Customer: undefined
+// Shopping cart: undefined
+// Header: Shows "Kund*in auswählen" again
+```
+
+**Host Classes:**
+```css
+h-[9.5rem] desktop:h-32 w-full flex flex-row justify-between rounded-2xl bg-isa-neutral-400 p-6
+```
+
+**Template Features:**
+- Displays customer name from `primaryBonusCard.firstName` and `lastName`
+- Shows available points with bold styling
+- Reset button (text button, subtle color, small size)
+- Selected rewards count with skeleton loader during fetch
+- "Prämienausgabe" CTA button (only shown when items selected and points > 0)
+
+---
+
+### RewardStartCardComponent
+
+Welcome card shown when no customer is selected, prompting customer selection.
+
+**Selector:** `reward-start-card`
+
+**Computed Signals:**
+
+#### `route: Signal<{ path: any[]; queryParams: any }>`
+
+Navigation route configuration for customer search.
+
+**Example value:**
+```typescript
+{
+  path: ['/kunde', 123, 'customer', {
+    outlets: { primary: 'search', side: 'search-customer-main' }
+  }],
+  queryParams: {
+    filter_customertype: 'webshop&loyalty;loyalty&!webshop'
+  }
+}
+```
+
+**Host Classes:**
+```css
+h-[9.5rem] desktop:h-32 w-full grid grid-cols-[1fr,auto] gap-6 rounded-2xl bg-isa-neutral-400 p-6 justify-between
+```
+
+**Template Features:**
+- Title: "Prämienshop" (subtitle-1-regular)
+- Description: Instructions for using the catalog
+- CTA Button: "Kund*in auswählen" (Select Customer)
+  - Color: tertiary
+  - Size: large
+  - Links to customer search with loyalty filter
+
+---
+
+### RewardListComponent
+
+Displays the paginated list of reward items with infinite scroll and loading states.
+
+**Selector:** `reward-list`
+
+**Inputs:**
+
+#### `searchTrigger: ModelSignal<SearchTrigger | 'reload' | 'initial'>`
+
+Two-way binding signal that triggers searches and pagination.
+
+**Type:** `'scan' | 'input' | 'filter' | 'orderBy' | 'reload' | 'initial'`
+
+**Default:** `'initial'`
+
+**Example:**
+```typescript
+<reward-list
+  [(searchTrigger)]="searchTrigger"
+></reward-list>
+```
+
+**Computed Signals:**
+
+#### `listFetching: Signal<boolean>`
+
+Whether the catalog resource is currently loading data.
+
+#### `items: Signal<Item[]>`
+
+Array of reward items to display.
+
+#### `itemsLength: Signal<number>`
+
+Number of items currently loaded.
+
+#### `hits: Signal<number>`
+
+Total number of items matching current filters.
+
+#### `renderSearchLoader: Signal<boolean>`
+
+Whether to show the initial search loader (when fetching with no items).
+
+#### `renderPageTrigger: Signal<boolean>`
+
+Whether to render the pagination trigger element (when more items exist and not currently loading).
+
+**Methods:**
+
+#### `paging(inViewport: boolean): void`
+
+Handles pagination when the trigger element comes into viewport.
+
+**Parameters:**
+- `inViewport: boolean` - Whether the trigger element is visible
+
+**Behavior:**
+```typescript
+// Called by (uiInViewport) directive
+if (inViewport && itemsLength < hits) {
+  searchTrigger.set('reload');  // Triggers next page load
+}
+```
+
+#### `resetFilter(): void`
+
+Resets all filters to default values and triggers a new search.
+
+**Example:**
+```typescript
+// Called when user clicks "Filter zurücksetzen" in empty state
+resetFilter();
+// All filters cleared
+// Query params updated
+// New search triggered
+```
+
+**Host Classes:**
+```css
+w-full flex flex-col gap-4
+```
+
+**Template Features:**
+- Result count display: `{{ hits() }} Einträge`
+- Item list with deferred rendering (viewport-based lazy loading)
+- Horizontal dividers between items on desktop
+- Loading spinner during pagination
+- Viewport trigger for infinite scroll
+- Empty state with reset button when no results
+
+---
+
+### RewardListItemComponent
+
+Individual reward item row with product information and selection checkbox.
+
+**Selector:** `reward-list-item`
+
+**Inputs:**
+
+#### `item: InputSignal<Item>`
+
+The reward item to display.
+
+**Required:** Yes
+
+**Type:** `Item` from `@isa/catalogue/data-access`
+
+**Example:**
+```typescript
+<reward-list-item
+  [item]="rewardItem"
+></reward-list-item>
+```
+
+**Computed Signals:**
+
+#### `desktopBreakpoint: Signal<boolean>`
+
+Whether the current viewport matches desktop breakpoints (Desktop, DesktopL, or DesktopXL).
+
+#### `productInfoOrientation: Signal<'horizontal' | 'vertical'>`
+
+Product info layout orientation based on viewport size.
+
+**Returns:** `'horizontal'` on desktop, `'vertical'` on tablet/mobile
+
+**Template Structure:**
+
+```html
+<ui-client-row>
+  <ui-client-row-content>
+    <checkout-product-info-redemption
+      [item]="item"
+      [orientation]="horizontal|vertical"
+    />
+  </ui-client-row-content>
+
+  <ui-item-row-data>
+    <checkout-stock-info [item]="item" />
+  </ui-item-row-data>
+
+  <ui-item-row-data>
+    <reward-list-item-select [item]="item" />
+  </ui-item-row-data>
+</ui-client-row>
+```
+
+**E2E Attributes:**
+- `data-what="reward-list-item"`
+- `[attr.data-which]="item.id"`
+
+---
+
+### RewardListItemSelectComponent
+
+Checkbox component for selecting/deselecting a reward item.
+
+**Selector:** `reward-list-item-select`
+
+**Inputs:**
+
+#### `item: InputSignal<Item>`
+
+The reward item associated with this selection control.
+
+**Required:** Yes
+
+**Computed Signals:**
+
+#### `itemSelected: Signal<boolean>`
+
+Whether the current item is selected in the store.
+
+**Methods:**
+
+#### `setSelected(selected: boolean): void`
+
+Updates the selection state in the RewardCatalogStore.
+
+**Parameters:**
+- `selected: boolean` - New selection state
+
+**Behavior:**
+```typescript
+if (selected) {
+  store.selectItem(itemId, item);  // Add to selection
+} else {
+  store.removeItem(itemId);        // Remove from selection
+}
+```
+
+**Example:**
+```typescript
+<ui-checkbox appearance="bullet">
+  <input
+    type="checkbox"
+    [ngModel]="itemSelected()"
+    (ngModelChange)="setSelected($event)"
+    data-what="reward-item-selection-checkbox"
+    [attr.data-which]="item.product.ean"
+  />
+</ui-checkbox>
+```
+
+---
+
+### RewardActionComponent
+
+Fixed bottom action bar with the "Prämie auswählen" (Select Reward) button.
+
+**Selector:** `reward-action`
+
+**Computed Signals:**
+
+#### `bonusCards: Signal<BonusCard[]>`
+
+Customer's bonus cards.
+
+#### `primaryBonusCard: Signal<BonusCard | undefined>`
+
+Primary bonus card with customer details.
+
+#### `primaryBonusCardPoints: Signal<number>`
+
+Available reading points for redemption.
+
+#### `selectedItems: Signal<Record<number, Item>>`
+
+Dictionary of selected items keyed by item ID.
+
+#### `hasSelectedItems: Signal<boolean>`
+
+Whether any items are currently selected.
+
+**Methods:**
+
+#### `async continueToPurchasingOptions(): Promise<void>`
+
+Opens the purchase options modal with selected items.
+
+**Workflow:**
+1. Retrieves selected items from store
+2. Gets or creates reward shopping cart ID
+3. Opens purchase options modal with redemption points enabled
+4. Waits for modal result
+5. Clears selected items on success
+6. Navigates to customer search if no customer and user didn't choose "continue-shopping"
+
+**Example:**
+```typescript
+await continueToPurchasingOptions();
+// Modal opens with selected items
+// User configures purchase options
+// On confirm: items added to cart, selections cleared
+// On cancel: nothing happens, selections preserved
+// If no customer: navigates to customer search
+```
+
+**Button Disabled Conditions:**
+```typescript
+!hasSelectedItems() ||                          // No items selected
+(!!primaryBonusCard() && primaryBonusCardPoints() <= 0)  // Customer has 0 points
+```
+
+## Usage Examples
+
+### Navigating to Reward Catalog
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router } from '@angular/router';
+import { injectTabId } from '@isa/core/tabs';
+
+@Component({
+  selector: 'app-navigation-example',
+  template: `
+    <button (click)="openRewardCatalog()">
+      Browse Rewards
+    </button>
+  `
+})
+export class NavigationExampleComponent {
+  #router = inject(Router);
+  tabId = injectTabId();
+
+  async openRewardCatalog(): Promise<void> {
+    await this.#router.navigate(['/kunde', this.tabId(), 'reward']);
+  }
+}
+```
+
+### Accessing Reward Catalog with Deep Link
+
+```typescript
+// Direct navigation with filter and search parameters
+async navigateWithFilters(): Promise<void> {
+  await this.#router.navigate(
+    ['/kunde', this.tabId(), 'reward'],
+    {
+      queryParams: {
+        search: 'book',
+        filter_category: 'literature',
+        orderBy: 'points_asc'
+      }
+    }
+  );
+}
+```
+
+### Programmatic Customer Selection
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { CrmTabMetadataService } from '@isa/crm/data-access';
+import { injectTabId } from '@isa/core/tabs';
+
+@Component({
+  selector: 'app-customer-selection-example',
+  template: '...'
+})
+export class CustomerSelectionExampleComponent {
+  #crmMetadata = inject(CrmTabMetadataService);
+  tabId = injectTabId();
+
+  selectCustomerForRewards(customerId: number): void {
+    // Set customer in tab metadata
+    this.#crmMetadata.setSelectedCustomerId(this.tabId()!, customerId);
+
+    // Navigate to reward catalog
+    this.#router.navigate(['/kunde', this.tabId(), 'reward']);
+
+    // Catalog will automatically load customer's bonus cards
+  }
+}
+```
+
+### Resetting Reward Session
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { CrmTabMetadataService } from '@isa/crm/data-access';
+import { CheckoutMetadataService } from '@isa/checkout/data-access';
+import { injectTabId } from '@isa/core/tabs';
+
+@Component({
+  selector: 'app-reset-example',
+  template: '...'
+})
+export class ResetExampleComponent {
+  #crmMetadata = inject(CrmTabMetadataService);
+  #checkoutMetadata = inject(CheckoutMetadataService);
+  tabId = injectTabId();
+
+  resetRewardSession(): void {
+    const tabId = this.tabId()!;
+
+    // Clear customer selection
+    this.#crmMetadata.setSelectedCustomerId(tabId, undefined);
+
+    // Clear reward shopping cart
+    this.#checkoutMetadata.setRewardShoppingCartId(tabId, undefined);
+
+    // User returns to guest workflow with RewardStartCard
+  }
+}
+```
+
+### Checking Customer Points Before Navigation
+
+```typescript
+import { Component, inject, signal } from '@angular/core';
+import { SelectedCustomerBonusCardsResource } from '@isa/crm/data-access';
+import { getPrimaryBonusCard } from '@isa/crm/data-access';
+import { computed } from '@angular/core';
+
+@Component({
+  selector: 'app-points-check-example',
+  template: `
+    @if (hasPoints()) {
+      <button (click)="navigateToRewards()">
+        Browse Rewards ({{ availablePoints() }} points)
+      </button>
+    } @else {
+      <p>Customer has no points available</p>
+    }
+  `
+})
+export class PointsCheckExampleComponent {
+  #bonusCardsResource = inject(SelectedCustomerBonusCardsResource).resource;
+
+  bonusCards = computed(() =>
+    this.#bonusCardsResource.value() ?? []
+  );
+
+  primaryCard = computed(() =>
+    getPrimaryBonusCard(this.bonusCards())
+  );
+
+  availablePoints = computed(() =>
+    this.primaryCard()?.totalPoints ?? 0
+  );
+
+  hasPoints = computed(() =>
+    this.availablePoints() > 0
+  );
+
+  navigateToRewards(): void {
+    if (this.hasPoints()) {
+      this.#router.navigate(['/kunde', this.tabId(), 'reward']);
+    }
+  }
+}
+```
+
+### Monitoring Shopping Cart State
+
+```typescript
+import { Component, inject, computed, effect } from '@angular/core';
+import { SelectedRewardShoppingCartResource } from '@isa/checkout/data-access';
+
+@Component({
+  selector: 'app-cart-monitor-example',
+  template: `
+    <div class="cart-summary">
+      <span>Rewards in cart: {{ cartItemCount() }}</span>
+      <span>Total points: {{ totalPoints() }}</span>
+    </div>
+  `
+})
+export class CartMonitorExampleComponent {
+  #cartResource = inject(SelectedRewardShoppingCartResource).resource;
+
+  cart = computed(() => this.#cartResource.value());
+
+  cartItemCount = computed(() =>
+    this.cart()?.items?.length ?? 0
+  );
+
+  totalPoints = computed(() => {
+    const items = this.cart()?.items ?? [];
+    return items.reduce((sum, item) =>
+      sum + (item.product?.loyaltyPoints ?? 0), 0
+    );
+  });
+
+  constructor() {
+    effect(() => {
+      console.log('Cart updated:', this.cart());
+    });
+  }
+}
+```
+
+## Routing and Navigation
+
+### Route Structure
+
+The library exports a single route configuration:
+
+```typescript
+// libs/checkout/feature/reward-catalog/src/lib/routes.ts
+export const routes: Routes = [
+  {
+    path: '',
+    component: RewardCatalogComponent,
+    resolve: {
+      querySettings: querySettingsResolverFn  // Fetches filter configuration
+    },
+    data: {
+      scrollPositionRestoration: true         // Enables scroll position restore
+    },
+  },
+];
+```
+
+### Integration in App Routing
+
+```typescript
+// apps/isa-app/src/app/app-routing.module.ts
+const routes: Routes = [
+  {
+    path: 'kunde/:tabId/reward',
+    loadChildren: () =>
+      import('@isa/checkout/feature/reward-catalog')
+        .then(m => m.routes),
+  },
+  // ... other routes
+];
+```
+
+### Query Settings Resolver
+
+The `querySettingsResolverFn` fetches filter configuration before component initialization:
+
+```typescript
+// What it does:
+1. Calls CatalogueSearchService.fetchLoyaltyQuerySettings()
+2. Returns QuerySettings with:
+   - Available filter options
+   - Sort options
+   - Default values
+   - Filter metadata
+3. Makes data available via ActivatedRoute.snapshot.data['querySettings']
+```
+
+**Usage in Component:**
+
+```typescript
+function querySettingsFactory() {
+  return inject(ActivatedRoute).snapshot.data['querySettings'];
+}
+
+// In providers array
+provideFilter(
+  withQuerySettingsFactory(querySettingsFactory),
+  withQueryParamsSync()
+)
+```
+
+### Customer Search Navigation
+
+Helper function for navigating to customer search from reward context:
+
+```typescript
+// libs/checkout/feature/reward-catalog/src/lib/helpers/get-route-to-customer.helper.ts
+export const getRouteToCustomer = (tabId: number | null) => {
+  return {
+    path: [
+      '/kunde',
+      tabId,
+      'customer',
+      { outlets: { primary: 'search', side: 'search-customer-main' } }
+    ].filter(Boolean),
+    queryParams: {
+      filter_customertype: 'webshop&loyalty;loyalty&!webshop'
+    }
+  };
+};
+```
+
+**Purpose:**
+- Navigates to customer search with loyalty customer filter pre-applied
+- Uses auxiliary routes for search UI
+- Filters out customers without loyalty cards
+
+### Scroll Position Restoration
+
+The library uses `@isa/utils/scroll-position` for automatic scroll restoration:
+
+```typescript
+// In RewardCatalogComponent
+restoreScrollPosition = injectRestoreScrollPosition();
+
+// Automatically:
+1. Saves scroll position on navigation away
+2. Restores position on return
+3. Works with infinite scroll pagination
+4. Respects route data configuration
+```
+
+## Filtering and Search
+
+### Filter Service Integration
+
+The library uses `@isa/shared/filter` with advanced configuration:
+
+```typescript
+provideFilter(
+  withQuerySettingsFactory(querySettingsFactory),  // Pre-loads filter config
+  withQueryParamsSync()                            // Syncs to URL query params
+)
+```
+
+### Filter Capabilities
+
+#### 1. Text Search
+
+```typescript
+// URL: ?search=book
+// Searches across:
+- Item names
+- Product descriptions
+- EAN/ISBN codes
+```
+
+#### 2. Category Filtering
+
+```typescript
+// URL: ?filter_category=literature
+// Filters by product category
+```
+
+#### 3. Point Range Filtering
+
+```typescript
+// URL: ?filter_points_min=100&filter_points_max=500
+// Filters items by redemption point range
+```
+
+#### 4. Sorting
+
+```typescript
+// URL: ?orderBy=points_asc
+// Available options:
+- points_asc: Points ascending
+- points_desc: Points descending
+- name_asc: Name A-Z
+- name_desc: Name Z-A
+```
+
+### Search Triggers
+
+The library supports multiple search trigger types:
+
+```typescript
+type SearchTrigger = 'scan' | 'input' | 'filter' | 'orderBy';
+
+// Additional internal triggers:
+'reload'   // Pagination (append to existing results)
+'initial'  // First load (check session storage first - currently disabled)
+```
+
+**Trigger Flow:**
+
+```typescript
+// User action → FilterControlsPanel emits triggerSearch
+FilterControlsPanel → search(trigger) → RewardCatalogComponent
+                                      ↓
+                        searchTrigger.set(trigger)
+                                      ↓
+                        filterService.commit()
+                                      ↓
+                        RewardListComponent detects change
+                                      ↓
+                        rewardCatalogResource reloads
+                                      ↓
+                        New items fetched and displayed
+```
+
+### Filter State Management
+
+#### Query Parameter Synchronization
+
+```typescript
+// Filter state automatically synced to URL
+// Example URL with filters:
+/kunde/123/reward?search=book&filter_category=literature&orderBy=points_asc
+
+// Benefits:
+1. Shareable URLs with filter state
+2. Browser back/forward support
+3. Bookmark-friendly
+4. Deep linking support
+```
+
+#### Filter Reset
+
+```typescript
+// Reset all filters to default
+resetFilter() {
+  this.#filterService.reset({ commit: true });
+}
+
+// Effects:
+1. All filter values cleared
+2. Search text cleared
+3. Sort order reset to default
+4. Query params updated
+5. New search triggered
+6. Items list refreshed
+```
+
+### Empty State Handling
+
+When no items match the current filters:
+
+```html
+<ui-empty-state
+  title="Keine Suchergebnisse"
+  description="Überprüfen Sie die Lesepunkte, Filter und Suchanfrage."
+>
+  <button uiButton (click)="resetFilter()">
+    Filter zurücksetzen
+  </button>
+</ui-empty-state>
+```
+
+## State Management
+
+### RewardCatalogStore
+
+The library uses `RewardCatalogStore` from `@isa/checkout/data-access` for state management.
+
+**Store Schema:**
+
+```typescript
+interface RewardCatalogState {
+  items: Item[];              // Current catalog items
+  hits: number;               // Total items matching filters
+  selectedItems: Record<number, Item>;  // Selected items by ID
+}
+```
+
+**Store Methods:**
+
+#### `setItems(items: Item[], hits: number): void`
+
+Replaces all items (used for new searches).
+
+```typescript
+// Called when searchTrigger !== 'reload'
+store.setItems(newItems, totalHits);
+```
+
+#### `updateItems(items: Item[], hits: number): void`
+
+Appends items to existing list (used for pagination).
+
+```typescript
+// Called when searchTrigger === 'reload'
+store.updateItems(nextPageItems, totalHits);
+```
+
+#### `selectItem(itemId: number, item: Item): void`
+
+Adds an item to the selection.
+
+```typescript
+store.selectItem(123, rewardItem);
+// selectedItems: { 123: rewardItem }
+```
+
+#### `removeItem(itemId: number): void`
+
+Removes an item from the selection.
+
+```typescript
+store.removeItem(123);
+// selectedItems: {}
+```
+
+#### `clearSelectedItems(): void`
+
+Clears all selected items.
+
+```typescript
+// Called after successful purchase options
+store.clearSelectedItems();
+// selectedItems: {}
+```
+
+#### `clearState(): void`
+
+Clears all catalog items and hits (preserves selectedItems).
+
+```typescript
+// Called when starting a new search
+store.clearState();
+// items: [], hits: 0
+```
+
+### Session Storage Persistence
+
+The store includes session storage integration (currently disabled):
+
+```typescript
+// TODO: Re-enable when storage configuration issue resolved (#5350, #5353)
+// await rewardCatalogStore.loadFromStorage();
+// if (rewardCatalogStore.items().length > 0) {
+//   return;  // Use cached items
+// }
+```
+
+**Intended Behavior:**
+- Selected items persist across page reloads
+- Catalog items cached in session storage
+- Fast initial render from cache
+- Background refresh ensures data freshness
+
+### Shopping Cart Resource
+
+`SelectedRewardShoppingCartResource` manages the reward shopping cart:
+
+```typescript
+// Provided at RewardCatalogComponent level
+// Automatically fetches cart based on CheckoutMetadataService.rewardShoppingCartId
+// Updates reactive signals when cart changes
+```
+
+**Resource Signals:**
+
+```typescript
+resource.value()      // Shopping cart data
+resource.isLoading()  // Loading state
+resource.error()      // Error state
+```
+
+### Customer Bonus Cards Resource
+
+`SelectedCustomerBonusCardsResource` manages customer bonus card data:
+
+```typescript
+// Provided at RewardCatalogComponent level
+// Automatically fetches based on CrmTabMetadataService.selectedCustomerId
+// Returns all bonus cards for the customer
+```
+
+**Resource Signals:**
+
+```typescript
+resource.value()      // BonusCard[]
+resource.isLoading()  // Loading state
+resource.error()      // Error state
+```
+
+## Architecture Notes
+
+### Component Hierarchy
+
+```
+RewardCatalogComponent (root, route component)
+├── RewardHeaderComponent
+│   ├── RewardStartCardComponent (guest workflow)
+│   └── RewardCustomerCardComponent (customer workflow)
+├── FilterControlsPanelComponent (from @isa/shared/filter)
+├── RewardListComponent
+│   └── RewardListItemComponent (repeated)
+│       ├── ProductInfoRedemptionComponent
+│       ├── StockInfoComponent
+│       └── RewardListItemSelectComponent
+└── RewardActionComponent
+```
+
+### Data Flow
+
+```
+1. Route Resolved
+   ↓
+2. querySettingsResolverFn fetches filter config
+   ↓
+3. RewardCatalogComponent initializes
+   ↓
+4. Filter service initialized with query settings
+   ↓
+5. Resources initialize (bonus cards, shopping cart)
+   ↓
+6. RewardListComponent creates catalog resource
+   ↓
+7. Catalog resource fetches items
+   ↓
+8. Items stored in RewardCatalogStore
+   ↓
+9. UI updates reactively
+```
+
+### Resource Pattern
+
+The library uses Angular's `resource()` function for data fetching:
+
+```typescript
+export const createRewardCatalogResource = (params: () => {
+  queryToken: QueryTokenInput;
+  searchTrigger: SearchTrigger | 'reload' | 'initial';
+}) => {
+  return resource({
+    params,
+    loader: async ({ abortSignal, params }) => {
+      // Fetch logic with automatic abort signal handling
+      // Params changes trigger automatic reload
+      // Loading states managed automatically
+    }
+  });
+};
+```
+
+**Benefits:**
+- Automatic cancellation of in-flight requests
+- Loading state management
+- Error handling
+- Reactive param tracking
+- AbortSignal integration
+
+### Tab Context Pattern
+
+The library uses tab metadata to track reward context:
+
+```typescript
+// Set in constructor
+this.#tabService.patchTabMetadata(tabId, { context: 'reward' });
+
+// Read in other components
+const metadata = this.#tabService.getTabMetadata(tabId);
+if (metadata.context === 'reward') {
+  // Customize behavior for reward flow
+}
+```
+
+**Purpose:**
+- Customer search knows user came from reward catalog
+- Can customize customer search filters
+- Enables "return to rewards" navigation
+- Tracks user intent across multi-step flows
+
+### Responsive Design Strategy
+
+The library uses breakpoint service for responsive layouts:
+
+```typescript
+import { breakpoint, Breakpoint } from '@isa/ui/layout';
+
+desktopBreakpoint = breakpoint([
+  Breakpoint.Desktop,
+  Breakpoint.DesktopL,
+  Breakpoint.DesktopXL
+]);
+
+productInfoOrientation = linkedSignal(() => {
+  return this.desktopBreakpoint() ? 'horizontal' : 'vertical';
+});
+```
+
+**Breakpoint Usage:**
+- Product info switches orientation (horizontal/vertical)
+- Row layouts change (grid on desktop, flex on tablet)
+- Component spacing adjusts
+- Font sizes and padding responsive
+
+### Known Architectural Considerations
+
+#### 1. Session Storage Integration (High Priority)
+
+**Current State:**
+- Session storage loading disabled due to configuration timing issue
+- Related to issues #5350, #5353
+- Store loads items too late, resource triggers before items available
+
+**Impact:**
+- Initial page load always fetches from server
+- No cache benefits
+- Slower perceived performance
+
+**Proposed Solution:**
+- Adjust storage loading timing
+- Ensure store hydration before resource initialization
+- Add configuration support for custom storage keys
+
+#### 2. Infinite Scroll Performance (Medium Priority)
+
+**Current State:**
+- Uses `@defer (on viewport)` for item rendering
+- Intersection observer for pagination trigger
+- All items rendered in single list
+
+**Potential Issues:**
+- Large lists (>1000 items) may impact performance
+- No virtual scrolling
+- Memory usage grows with item count
+
+**Proposed Solution:**
+- Implement virtual scrolling with CDK
+- Render only visible items plus buffer
+- Recycle DOM elements
+
+#### 3. Purchase Options Modal Coupling (Low Priority)
+
+**Current State:**
+- Direct dependency on `@modal/purchase-options`
+- Modal opened imperatively in component
+
+**Consideration:**
+- Could be abstracted to a service
+- Better testability
+- Easier to replace modal implementation
+
+#### 4. Customer Selection Navigation (Low Priority)
+
+**Current State:**
+- Hard-coded route to customer search
+- Uses auxiliary routes (primary/side outlets)
+
+**Consideration:**
+- Could use navigation service for flexibility
+- Easier to customize per deployment
+- Better separation of concerns
+
+### Performance Optimizations
+
+1. **OnPush Change Detection** - All components use OnPush for minimal re-renders
+2. **Deferred Rendering** - List items use `@defer (on viewport)` for lazy loading
+3. **Linked Signals** - Computed values only recalculate when dependencies change
+4. **Resource Caching** - Shopping cart and bonus cards fetched once per session
+5. **Query Param Debouncing** - Filter changes debounced before URL update
+
+## Dependencies
+
+### Required Libraries
+
+#### Angular Core
+- `@angular/core` - Angular framework
+- `@angular/router` - Routing and navigation
+- `@angular/forms` - FormsModule for checkbox binding
+
+#### ISA Feature Libraries
+- `@isa/checkout/data-access` - RewardCatalogStore, ShoppingCartFacade, CheckoutMetadataService
+- `@isa/checkout/shared/product-info` - ProductInfoRedemptionComponent, StockInfoComponent
+- `@isa/catalogue/data-access` - CatalogueSearchService, Item type, QuerySettings
+- `@isa/crm/data-access` - Customer bonus cards, getPrimaryBonusCard, CrmTabMetadataService
+- `@isa/shared/filter` - Filter service, query param sync, FilterControlsPanelComponent
+- `@isa/core/tabs` - Tab service, injectTabId
+- `@isa/utils/scroll-position` - Scroll position restoration
+
+#### ISA UI Libraries
+- `@isa/ui/buttons` - ButtonComponent, TextButtonComponent, IconButtonComponent
+- `@isa/ui/input-controls` - CheckboxComponent
+- `@isa/ui/item-rows` - ClientRowImports, ItemRowDataImports
+- `@isa/ui/empty-state` - EmptyStateComponent
+- `@isa/ui/layout` - InViewportDirective, breakpoint service
+- `@isa/ui/skeleton-loader` - SkeletonLoaderDirective
+
+#### Modal Services
+- `@modal/purchase-options` - PurchaseOptionsModalService
+
+#### Third-party
+- `rxjs` - firstValueFrom for observable handling
+
+### Path Alias
+
+Import from: `@isa/checkout/feature/reward-catalog`
+
+```typescript
+// Import routes
+import { routes } from '@isa/checkout/feature/reward-catalog';
+
+// Import helpers (if needed)
+import { getRouteToCustomer } from '@isa/checkout/feature/reward-catalog';
+```
+
+## Testing
+
+The library uses **Vitest** with **Angular Testing Utilities** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test reward-catalog --skip-nx-cache
+
+# Run tests with coverage
+npx nx test reward-catalog --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test reward-catalog --watch
+```
+
+### Test Coverage
+
+Current test files:
+- `get-route-to-customer.helper.spec.ts` - Helper function unit tests
+
+**Test Coverage:**
+
+```typescript
+describe('getRouteToCustomer', () => {
+  it('should return route with tabId when provided');
+  it('should filter out null tabId from path');
+  it('should always include customer type filter in query params');
+  it('should have consistent structure regardless of tabId');
+  it('should include outlets configuration in path');
+});
+```
+
+### Testing Recommendations
+
+#### Component Testing
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { RewardCatalogComponent } from './reward-catalog.component';
+import { ActivatedRoute } from '@angular/router';
+
+describe('RewardCatalogComponent', () => {
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      imports: [RewardCatalogComponent],
+      providers: [
+        {
+          provide: ActivatedRoute,
+          useValue: {
+            snapshot: {
+              data: {
+                querySettings: {
+                  // Mock query settings
+                }
+              }
+            }
+          }
+        }
+      ]
+    });
+  });
+
+  it('should initialize reward context', () => {
+    const component = TestBed.createComponent(RewardCatalogComponent).componentInstance;
+    // Assert tab metadata set to 'reward'
+  });
+});
+```
+
+#### Resource Testing
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { describe, it, expect, vi } from 'vitest';
+import { createRewardCatalogResource } from './reward-catalog.resource';
+
+describe('createRewardCatalogResource', () => {
+  it('should fetch items on initial load', async () => {
+    const mockService = {
+      searchLoyaltyItems: vi.fn().mockResolvedValue({
+        result: [/* mock items */],
+        hits: 10
+      })
+    };
+
+    // Test resource creation and loading
+  });
+
+  it('should append items on reload trigger', async () => {
+    // Test pagination behavior
+  });
+});
+```
+
+#### Store Integration Testing
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { describe, it, expect } from 'vitest';
+import { RewardCatalogStore } from '@isa/checkout/data-access';
+
+describe('RewardCatalogStore Integration', () => {
+  it('should select and deselect items', () => {
+    const store = TestBed.inject(RewardCatalogStore);
+
+    store.selectItem(123, mockItem);
+    expect(store.selectedItems()[123]).toBeDefined();
+
+    store.removeItem(123);
+    expect(store.selectedItems()[123]).toBeUndefined();
+  });
+});
+```
+
+### E2E Attribute Requirements
+
+All interactive elements include `data-what` and `data-which` attributes for E2E testing:
+
+```html
+<!-- List item -->
+<ui-client-row
+  data-what="reward-list-item"
+  [attr.data-which]="item.id">
+</ui-client-row>
+
+<!-- Selection checkbox -->
+<input
+  type="checkbox"
+  data-what="reward-item-selection-checkbox"
+  [attr.data-which]="item.product.ean"
+/>
+
+<!-- Customer selection CTA -->
+<a
+  data-what="select-customer"
+  data-which="select-customer"
+  uiButton
+  [routerLink]="route().path">
+</a>
+
+<!-- Checkout CTA -->
+<a
+  data-what="continue-to-reward-checkout"
+  data-which="continue-to-reward-checkout"
+  uiButton
+  routerLink="./cart">
+</a>
+
+<!-- Select rewards button -->
+<button
+  data-what="select-rewards"
+  data-which="select-rewards"
+  uiButton
+  (click)="continueToPurchasingOptions()">
+</button>
+```
+
+## Best Practices
+
+### 1. Always Use Tab Context
+
+When navigating to the reward catalog, ensure tab context is available:
+
+```typescript
+// Good
+const tabId = this.#tabService.activatedTabId();
+if (tabId) {
+  this.#router.navigate(['/kunde', tabId, 'reward']);
+}
+
+// Bad (missing tab context)
+this.#router.navigate(['/reward']);
+```
+
+### 2. Check Customer Points Before Enabling Features
+
+Always verify customer has points before allowing reward selection:
+
+```typescript
+// Good
+const hasPoints = computed(() => {
+  const points = this.primaryBonusCard()?.totalPoints ?? 0;
+  return points > 0;
+});
+
+<button [disabled]="!hasPoints()">Browse Rewards</button>
+
+// Bad (no validation)
+<button>Browse Rewards</button>
+```
+
+### 3. Clean Up on Customer Change
+
+Always clear reward context when customer changes:
+
+```typescript
+// Good
+resetCustomerAndCart() {
+  this.#crmMetadata.setSelectedCustomerId(tabId, undefined);
+  this.#checkoutMetadata.setRewardShoppingCartId(tabId, undefined);
+}
+
+// Bad (leaves stale cart)
+resetCustomer() {
+  this.#crmMetadata.setSelectedCustomerId(tabId, undefined);
+  // Forgot to clear shopping cart!
+}
+```
+
+### 4. Use Computed Signals for Derived State
+
+Leverage Angular signals for reactive derived values:
+
+```typescript
+// Good
+primaryBonusCard = computed(() =>
+  getPrimaryBonusCard(this.bonusCards())
+);
+
+availablePoints = computed(() =>
+  this.primaryBonusCard()?.totalPoints ?? 0
+);
+
+// Bad (manual tracking)
+availablePoints = 0;
+ngOnInit() {
+  effect(() => {
+    const card = getPrimaryBonusCard(this.bonusCards());
+    this.availablePoints = card?.totalPoints ?? 0;
+  });
+}
+```
+
+### 5. Handle Modal Results Properly
+
+Always handle both success and cancel cases from purchase options modal:
+
+```typescript
+// Good
+const result = await firstValueFrom(modalRef.afterClosed$);
+if (!result?.data) {
+  return;  // User cancelled, do nothing
+}
+
+this.#store.clearSelectedItems();
+
+if (result.data !== 'continue-shopping') {
+  await this.#navigation(tabId);
+}
+
+// Bad (doesn't handle cancel)
+const result = await firstValueFrom(modalRef.afterClosed$);
+this.#store.clearSelectedItems();  // Clears even on cancel!
+```
+
+### 6. Use Breakpoint Service for Responsive Layouts
+
+Use the breakpoint service instead of CSS-only solutions:
+
+```typescript
+// Good
+desktopBreakpoint = breakpoint([
+  Breakpoint.Desktop,
+  Breakpoint.DesktopL,
+  Breakpoint.DesktopXL
+]);
+
+orientation = linkedSignal(() =>
+  this.desktopBreakpoint() ? 'horizontal' : 'vertical'
+);
+
+// Bad (CSS hidden classes)
+<div class="hidden desktop:block">...</div>
+<div class="block desktop:hidden">...</div>
+```
+
+### 7. Preserve Filter State in URLs
+
+Always use query parameters for filter state to enable bookmarking and sharing:
+
+```typescript
+// Good (automatic via withQueryParamsSync)
+provideFilter(
+  withQuerySettingsFactory(querySettingsFactory),
+  withQueryParamsSync()
+)
+
+// Bad (component-local state)
+filters = signal({ category: null, points: null });
+```
+
+### 8. Test E2E Attributes
+
+Verify E2E attributes are present in component tests:
+
+```typescript
+// Good
+it('should have E2E attributes on list items', () => {
+  const listItem = fixture.nativeElement.querySelector('[data-what="reward-list-item"]');
+  expect(listItem).toBeTruthy();
+  expect(listItem.getAttribute('data-which')).toBe('123');
+});
+
+// Bad (no E2E attribute verification)
+it('should render list items', () => {
+  const listItem = fixture.nativeElement.querySelector('ui-client-row');
+  expect(listItem).toBeTruthy();
+});
+```
+
+### 9. Use Resource Pattern for Data Fetching
+
+Prefer resource pattern over manual service calls for better loading state management:
+
+```typescript
+// Good
+rewardCatalogResource = createRewardCatalogResource(() => ({
+  queryToken: this.#filterService.query(),
+  searchTrigger: this.searchTrigger()
+}));
+
+isLoading = linkedSignal(() =>
+  this.rewardCatalogResource.status() === 'loading'
+);
+
+// Bad (manual loading state)
+isLoading = signal(false);
+
+async loadItems() {
+  this.isLoading.set(true);
+  try {
+    const items = await this.#service.searchItems();
+  } finally {
+    this.isLoading.set(false);
+  }
+}
+```
+
+### 10. Follow OnPush Change Detection
+
+Always use OnPush change detection for performance:
+
+```typescript
+// Good (all components in this library)
+@Component({
+  selector: 'reward-catalog',
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  // ...
+})
+
+// Bad (default change detection)
+@Component({
+  selector: 'reward-catalog',
+  // Missing changeDetection - uses Default
+})
+```
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/checkout/feature/reward-order-confirmation/README.md b/libs/checkout/feature/reward-order-confirmation/README.md
new file mode 100644
index 000000000..8328c04d0
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/README.md
@@ -0,0 +1,7 @@
+# checkout-feature-reward-order-confirmation
+
+This library was generated with [Nx](https://nx.dev).
+
+## Running unit tests
+
+Run `nx test checkout-feature-reward-order-confirmation` to execute the unit tests.
diff --git a/libs/checkout/feature/reward-order-confirmation/eslint.config.cjs b/libs/checkout/feature/reward-order-confirmation/eslint.config.cjs
new file mode 100644
index 000000000..88fe1e297
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/eslint.config.cjs
@@ -0,0 +1,34 @@
+const nx = require('@nx/eslint-plugin');
+const baseConfig = require('../../../../eslint.config.js');
+
+module.exports = [
+  ...baseConfig,
+  ...nx.configs['flat/angular'],
+  ...nx.configs['flat/angular-template'],
+  {
+    files: ['**/*.ts'],
+    rules: {
+      '@angular-eslint/directive-selector': [
+        'error',
+        {
+          type: 'attribute',
+          prefix: 'checkout',
+          style: 'camelCase',
+        },
+      ],
+      '@angular-eslint/component-selector': [
+        'error',
+        {
+          type: 'element',
+          prefix: 'checkout',
+          style: 'kebab-case',
+        },
+      ],
+    },
+  },
+  {
+    files: ['**/*.html'],
+    // Override or add rules here
+    rules: {},
+  },
+];
diff --git a/libs/checkout/feature/reward-order-confirmation/project.json b/libs/checkout/feature/reward-order-confirmation/project.json
new file mode 100644
index 000000000..a0a80d85b
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/project.json
@@ -0,0 +1,20 @@
+{
+  "name": "checkout-feature-reward-order-confirmation",
+  "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/checkout/feature/reward-order-confirmation/src",
+  "prefix": "checkout",
+  "projectType": "library",
+  "tags": [],
+  "targets": {
+    "test": {
+      "executor": "@nx/vite:test",
+      "outputs": ["{options.reportsDirectory}"],
+      "options": {
+        "reportsDirectory": "../../../../coverage/libs/checkout/feature/reward-order-confirmation"
+      }
+    },
+    "lint": {
+      "executor": "@nx/eslint:lint"
+    }
+  }
+}
diff --git a/libs/checkout/feature/reward-order-confirmation/src/index.ts b/libs/checkout/feature/reward-order-confirmation/src/index.ts
new file mode 100644
index 000000000..c0a5d360b
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/src/index.ts
@@ -0,0 +1 @@
+export * from './lib/routes';
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-addresses/order-confirmation-addresses.component.css b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-addresses/order-confirmation-addresses.component.css
new file mode 100644
index 000000000..e69de29bb
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-addresses/order-confirmation-addresses.component.html b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-addresses/order-confirmation-addresses.component.html
new file mode 100644
index 000000000..05ef60286
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-addresses/order-confirmation-addresses.component.html
@@ -0,0 +1 @@
+<h1>Order Confirmation Addresses</h1>
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-addresses/order-confirmation-addresses.component.ts b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-addresses/order-confirmation-addresses.component.ts
new file mode 100644
index 000000000..4229dc3c7
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-addresses/order-confirmation-addresses.component.ts
@@ -0,0 +1,10 @@
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+
+@Component({
+  selector: 'checkout-order-confirmation-addresses',
+  templateUrl: './order-confirmation-addresses.component.html',
+  styleUrls: ['./order-confirmation-addresses.component.css'],
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  imports: [],
+})
+export class OrderConfirmationAddressesComponent {}
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-header/order-confirmation-header.component.css b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-header/order-confirmation-header.component.css
new file mode 100644
index 000000000..e69de29bb
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-header/order-confirmation-header.component.html b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-header/order-confirmation-header.component.html
new file mode 100644
index 000000000..a669d2c1d
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-header/order-confirmation-header.component.html
@@ -0,0 +1 @@
+<h1>Order Confirmation Header</h1>
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-header/order-confirmation-header.component.ts b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-header/order-confirmation-header.component.ts
new file mode 100644
index 000000000..4b6f940b6
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-header/order-confirmation-header.component.ts
@@ -0,0 +1,10 @@
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+
+@Component({
+  selector: 'checkout-order-confirmation-header',
+  templateUrl: './order-confirmation-header.component.html',
+  styleUrls: ['./order-confirmation-header.component.css'],
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  imports: [],
+})
+export class OrderConfirmationHeaderComponent {}
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list-item/order-confirmation-item-list-item.component.css b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list-item/order-confirmation-item-list-item.component.css
new file mode 100644
index 000000000..e69de29bb
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list-item/order-confirmation-item-list-item.component.html b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list-item/order-confirmation-item-list-item.component.html
new file mode 100644
index 000000000..022dc1a08
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list-item/order-confirmation-item-list-item.component.html
@@ -0,0 +1 @@
+<h1>Order Confirmation Item List Item</h1>
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list-item/order-confirmation-item-list-item.component.ts b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list-item/order-confirmation-item-list-item.component.ts
new file mode 100644
index 000000000..83cd2d16b
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list-item/order-confirmation-item-list-item.component.ts
@@ -0,0 +1,10 @@
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+
+@Component({
+  selector: 'checkout-order-confirmation-item-list-item',
+  templateUrl: './order-confirmation-item-list-item.component.html',
+  styleUrls: ['./order-confirmation-item-list-item.component.css'],
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  imports: [],
+})
+export class OrderConfirmationItemListItemComponent {}
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list.component.css b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list.component.css
new file mode 100644
index 000000000..e69de29bb
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list.component.html b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list.component.html
new file mode 100644
index 000000000..3d719af60
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list.component.html
@@ -0,0 +1 @@
+<h1>Order Confirmation Item List</h1>
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list.component.ts b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list.component.ts
new file mode 100644
index 000000000..a4e2e2fcc
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/src/lib/order-confirmation-item-list/order-confirmation-item-list.component.ts
@@ -0,0 +1,12 @@
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+
+import { OrderConfirmationItemListItemComponent } from './order-confirmation-item-list-item/order-confirmation-item-list-item.component';
+
+@Component({
+  selector: 'checkout-order-confirmation-item-list',
+  templateUrl: './order-confirmation-item-list.component.html',
+  styleUrls: ['./order-confirmation-item-list.component.css'],
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  imports: [OrderConfirmationItemListItemComponent],
+})
+export class OrderConfirmationItemListComponent {}
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/reward-order-confirmation.component.css b/libs/checkout/feature/reward-order-confirmation/src/lib/reward-order-confirmation.component.css
new file mode 100644
index 000000000..e69de29bb
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/reward-order-confirmation.component.html b/libs/checkout/feature/reward-order-confirmation/src/lib/reward-order-confirmation.component.html
new file mode 100644
index 000000000..b98518554
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/src/lib/reward-order-confirmation.component.html
@@ -0,0 +1 @@
+<checkout-order-confirmation-header></checkout-order-confirmation-header>
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/reward-order-confirmation.component.ts b/libs/checkout/feature/reward-order-confirmation/src/lib/reward-order-confirmation.component.ts
new file mode 100644
index 000000000..139f32573
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/src/lib/reward-order-confirmation.component.ts
@@ -0,0 +1,58 @@
+import {
+  ChangeDetectionStrategy,
+  Component,
+  computed,
+  effect,
+  inject,
+  untracked,
+} from '@angular/core';
+import { toSignal } from '@angular/core/rxjs-interop';
+
+import { OrderConfirmationAddressesComponent } from './order-confirmation-addresses/order-confirmation-addresses.component';
+import { OrderConfirmationHeaderComponent } from './order-confirmation-header/order-confirmation-header.component';
+import { OrderConfirmationItemListComponent } from './order-confirmation-item-list/order-confirmation-item-list.component';
+import { ActivatedRoute } from '@angular/router';
+import { JsonPipe } from '@angular/common';
+import { OmsMetadataService } from '@isa/oms/data-access';
+import { TabService } from '@isa/core/tabs';
+import { OrderConfiramtionStore } from './reward-order-confirmation.store';
+
+@Component({
+  selector: 'checkout-reward-order-confirmation',
+  templateUrl: './reward-order-confirmation.component.html',
+  styleUrls: ['./reward-order-confirmation.component.css'],
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  imports: [
+    OrderConfirmationHeaderComponent,
+    OrderConfirmationAddressesComponent,
+    OrderConfirmationItemListComponent,
+  ],
+  providers: [OrderConfiramtionStore],
+})
+export class RewardOrderConfirmationComponent {
+  #store = inject(OrderConfiramtionStore);
+  #tabId = inject(TabService).activatedTabId;
+  #activatedRoute = inject(ActivatedRoute);
+
+  params = toSignal(this.#activatedRoute.paramMap);
+
+  orderIds = computed(() => {
+    const params = this.params();
+    if (!params) {
+      return [];
+    }
+    const param = params.get('orderIds');
+    return param ? param.split('+').map((strId) => parseInt(strId, 10)) : [];
+  });
+
+  constructor() {
+    effect(() => {
+      const tabId = this.#tabId() || undefined;
+      const orderIds = this.orderIds();
+
+      untracked(() => {
+        this.#store.patch({ tabId, orderIds });
+      });
+    });
+  }
+}
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/reward-order-confirmation.store.ts b/libs/checkout/feature/reward-order-confirmation/src/lib/reward-order-confirmation.store.ts
new file mode 100644
index 000000000..34c4256ae
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/src/lib/reward-order-confirmation.store.ts
@@ -0,0 +1,50 @@
+import { computed, inject, resource } from '@angular/core';
+import { OmsMetadataService } from '@isa/oms/data-access';
+import {
+  patchState,
+  signalStore,
+  withComputed,
+  withMethods,
+  withProps,
+  withState,
+} from '@ngrx/signals';
+
+type OrderConfiramtionState = {
+  tabId: number | undefined;
+  orderIds: number[] | undefined;
+};
+
+const initialState: OrderConfiramtionState = {
+  tabId: undefined,
+  orderIds: undefined,
+};
+
+export const OrderConfiramtionStore = signalStore(
+  withState(initialState),
+  withProps(() => ({
+    _omsMetadataService: inject(OmsMetadataService),
+  })),
+  withComputed((state) => ({
+    orders: computed(() => {
+      const tabId = state.tabId();
+      const orderIds = state.orderIds();
+
+      if (!tabId) {
+        return undefined;
+      }
+
+      if (!orderIds || !orderIds.length) {
+        return undefined;
+      }
+
+      const orders = state._omsMetadataService.getDisplayOrders(tabId);
+
+      return orders?.filter((order) => orderIds.includes(order.id!));
+    }),
+  })),
+  withMethods((store) => ({
+    patch(partial: Partial<OrderConfiramtionState>) {
+      patchState(store, partial);
+    },
+  })),
+);
diff --git a/libs/checkout/feature/reward-order-confirmation/src/lib/routes.ts b/libs/checkout/feature/reward-order-confirmation/src/lib/routes.ts
new file mode 100644
index 000000000..6817f02cf
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/src/lib/routes.ts
@@ -0,0 +1,12 @@
+import { Routes } from '@angular/router';
+import { RewardOrderConfirmationComponent } from './reward-order-confirmation.component';
+
+export const routes: Routes = [
+  {
+    path: ':orderIds',
+    loadComponent: () =>
+      import('./reward-order-confirmation.component').then(
+        (m) => m.RewardOrderConfirmationComponent,
+      ),
+  },
+];
diff --git a/libs/checkout/feature/reward-order-confirmation/src/test-setup.ts b/libs/checkout/feature/reward-order-confirmation/src/test-setup.ts
new file mode 100644
index 000000000..cebf5ae72
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/src/test-setup.ts
@@ -0,0 +1,13 @@
+import '@angular/compiler';
+import '@analogjs/vitest-angular/setup-zone';
+
+import {
+  BrowserTestingModule,
+  platformBrowserTesting,
+} from '@angular/platform-browser/testing';
+import { getTestBed } from '@angular/core/testing';
+
+getTestBed().initTestEnvironment(
+  BrowserTestingModule,
+  platformBrowserTesting(),
+);
diff --git a/libs/checkout/feature/reward-order-confirmation/tsconfig.json b/libs/checkout/feature/reward-order-confirmation/tsconfig.json
new file mode 100644
index 000000000..06f8b89a6
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/tsconfig.json
@@ -0,0 +1,30 @@
+{
+  "extends": "../../../../tsconfig.base.json",
+  "compilerOptions": {
+    "importHelpers": true,
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noImplicitOverride": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "module": "preserve"
+  },
+  "angularCompilerOptions": {
+    "enableI18nLegacyMessageIdFormat": false,
+    "strictInjectionParameters": true,
+    "strictInputAccessModifiers": true,
+    "typeCheckHostBindings": true,
+    "strictTemplates": true
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    },
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ]
+}
diff --git a/libs/checkout/feature/reward-order-confirmation/tsconfig.lib.json b/libs/checkout/feature/reward-order-confirmation/tsconfig.lib.json
new file mode 100644
index 000000000..9259117c2
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/tsconfig.lib.json
@@ -0,0 +1,27 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../../../dist/out-tsc",
+    "declaration": true,
+    "declarationMap": true,
+    "inlineSources": true,
+    "types": []
+  },
+  "exclude": [
+    "src/**/*.spec.ts",
+    "src/test-setup.ts",
+    "jest.config.ts",
+    "src/**/*.test.ts",
+    "vite.config.ts",
+    "vite.config.mts",
+    "vitest.config.ts",
+    "vitest.config.mts",
+    "src/**/*.test.tsx",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.js",
+    "src/**/*.spec.js",
+    "src/**/*.test.jsx",
+    "src/**/*.spec.jsx"
+  ],
+  "include": ["src/**/*.ts"]
+}
diff --git a/libs/checkout/feature/reward-order-confirmation/tsconfig.spec.json b/libs/checkout/feature/reward-order-confirmation/tsconfig.spec.json
new file mode 100644
index 000000000..b2f92f3ec
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/tsconfig.spec.json
@@ -0,0 +1,29 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../../../dist/out-tsc",
+    "types": [
+      "vitest/globals",
+      "vitest/importMeta",
+      "vite/client",
+      "node",
+      "vitest"
+    ]
+  },
+  "include": [
+    "vite.config.ts",
+    "vite.config.mts",
+    "vitest.config.ts",
+    "vitest.config.mts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.test.tsx",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.js",
+    "src/**/*.spec.js",
+    "src/**/*.test.jsx",
+    "src/**/*.spec.jsx",
+    "src/**/*.d.ts"
+  ],
+  "files": ["src/test-setup.ts"]
+}
diff --git a/libs/checkout/feature/reward-order-confirmation/vite.config.mts b/libs/checkout/feature/reward-order-confirmation/vite.config.mts
new file mode 100644
index 000000000..a8df9a7c6
--- /dev/null
+++ b/libs/checkout/feature/reward-order-confirmation/vite.config.mts
@@ -0,0 +1,29 @@
+/// <reference types='vitest' />
+import { defineConfig } from 'vite';
+import angular from '@analogjs/vite-plugin-angular';
+import { nxViteTsPaths } from '@nx/vite/plugins/nx-tsconfig-paths.plugin';
+import { nxCopyAssetsPlugin } from '@nx/vite/plugins/nx-copy-assets.plugin';
+
+export default defineConfig(() => ({
+  root: __dirname,
+  cacheDir:
+    '../../../../node_modules/.vite/libs/checkout/feature/reward-order-confirmation',
+  plugins: [angular(), nxViteTsPaths(), nxCopyAssetsPlugin(['*.md'])],
+  // Uncomment this if you are using workers.
+  // worker: {
+  //  plugins: [ nxViteTsPaths() ],
+  // },
+  test: {
+    watch: false,
+    globals: true,
+    environment: 'jsdom',
+    include: ['{src,tests}/**/*.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}'],
+    setupFiles: ['src/test-setup.ts'],
+    reporters: ['default'],
+    coverage: {
+      reportsDirectory:
+        '../../../../coverage/libs/checkout/feature/reward-order-confirmation',
+      provider: 'v8' as const,
+    },
+  },
+}));
diff --git a/libs/checkout/feature/reward-shopping-cart/README.md b/libs/checkout/feature/reward-shopping-cart/README.md
index ca7a13fd8..c18ad1df8 100644
--- a/libs/checkout/feature/reward-shopping-cart/README.md
+++ b/libs/checkout/feature/reward-shopping-cart/README.md
@@ -1,7 +1,1691 @@
-# checkout-feature-reward-shopping-cart
+# @isa/checkout/feature/reward-shopping-cart
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive reward shopping cart feature for Angular applications supporting loyalty points redemption workflow across retail operations.
 
-## Running unit tests
+## Overview
 
-Run `nx test checkout-feature-reward-shopping-cart` to execute the unit tests.
+The Reward Shopping Cart feature library provides a complete user interface for managing loyalty point redemptions through the ISA rewards program. It integrates customer bonus card data, shopping cart management, delivery address selection, and order completion into a unified checkout flow specifically designed for reward items (Prämienausgabe). The library coordinates between CRM data, checkout services, and OMS order creation to enable seamless reward fulfillment.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Component Architecture](#component-architecture)
+- [Component API Reference](#component-api-reference)
+- [Usage Examples](#usage-examples)
+- [Routing and Navigation](#routing-and-navigation)
+- [Shopping Cart Management](#shopping-cart-management)
+- [Checkout Workflow](#checkout-workflow)
+- [State Management](#state-management)
+- [Architecture Notes](#architecture-notes)
+- [Dependencies](#dependencies)
+- [Testing](#testing)
+- [Best Practices](#best-practices)
+
+## Features
+
+- **Loyalty points integration** - Display customer bonus card points and redemption costs
+- **Reactive shopping cart** - Real-time cart updates with quantity controls and item removal
+- **Availability checking** - Automatic stock validation with responsive quantity limits
+- **Address management** - Display and edit billing/shipping addresses with CRM integration
+- **Order completion** - Orchestrated checkout with cross-domain coordination (Checkout + OMS)
+- **Responsive design** - Adaptive layouts for desktop (horizontal) and tablet (vertical)
+- **Optimistic updates** - Immediate UI feedback with background resource reloading
+- **Error handling** - Comprehensive logging and graceful error recovery
+- **E2E testing attributes** - Full support for automated testing with data-* attributes
+- **Deferred rendering** - Viewport-based lazy loading for optimal performance
+
+## Quick Start
+
+### 1. Import Routes
+
+```typescript
+// app-routing.module.ts
+import { routes as rewardShoppingCartRoutes } from '@isa/checkout/feature/reward-shopping-cart';
+
+const routes: Routes = [
+  {
+    path: 'reward/cart',
+    loadChildren: () => rewardShoppingCartRoutes
+  }
+];
+```
+
+### 2. Navigate to Shopping Cart
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-product-list',
+  template: '...'
+})
+export class ProductListComponent {
+  #router = inject(Router);
+
+  async viewRewardCart(tabId: number): Promise<void> {
+    await this.#router.navigate(['/', tabId, 'reward', 'cart']);
+  }
+}
+```
+
+### 3. Prerequisites
+
+Before navigating to the reward shopping cart, ensure:
+
+```typescript
+// 1. Customer is selected (required for bonus points)
+crmTabMetadataService.selectCustomer(tabId, customerId);
+
+// 2. Reward shopping cart exists (created automatically when adding items)
+checkoutMetadataService.getRewardShoppingCartId(tabId); // Should return valid ID
+
+// 3. At least one item in the cart
+// Items are added via RewardSelectionDialog or directly via ShoppingCartFacade
+```
+
+## Component Architecture
+
+The library follows a hierarchical component structure with clear separation of concerns:
+
+```
+RewardShoppingCartComponent (Root)
+├─ NavigateBackButtonComponent (Navigation)
+├─ CheckoutCustomerRewardCardComponent (Customer/Points Display)
+├─ BillingAndShippingAddressCardComponent (Address Management)
+├─ RewardShoppingCartItemsComponent (Item List Container)
+│  └─ RewardShoppingCartItemComponent (Individual Item)
+│     ├─ ProductInfoRedemptionComponent (Product Display)
+│     ├─ DestinationInfoComponent (Delivery Info)
+│     ├─ RewardShoppingCartItemQuantityControlComponent (Quantity)
+│     └─ RewardShoppingCartItemRemoveButtonComponent (Remove)
+├─ CompleteOrderButtonComponent (Checkout Action)
+└─ RewardSelectionTriggerComponent (Back to Selection)
+```
+
+### Component Responsibilities
+
+**RewardShoppingCartComponent (Root)**
+- Coordinates all child components
+- Provides shared resources (SelectedRewardShoppingCartResource, SelectedCustomerResource)
+- Manages overall layout and page structure
+
+**CheckoutCustomerRewardCardComponent**
+- Displays customer name and bonus card points
+- Shows selected items count and total points required
+- Calculates remaining points after redemption
+
+**BillingAndShippingAddressCardComponent**
+- Displays billing and shipping addresses from CRM customer data
+- Provides edit button to navigate to customer details
+- Uses NavigationStateService for preserved context
+
+**RewardShoppingCartItemsComponent**
+- Container for shopping cart items
+- Filters out items without product data
+- Implements deferred loading for performance
+
+**RewardShoppingCartItemComponent**
+- Displays individual cart item with product information
+- Manages busy state for item operations
+- Handles purchase option updates via modal
+- Responsive layout switching (horizontal/vertical)
+
+**RewardShoppingCartItemQuantityControlComponent**
+- Manages item quantity with availability validation
+- Automatically updates cart on quantity changes
+- Handles price overrides for redemption items (sets to 0)
+- Implements reactive availability checking
+
+**RewardShoppingCartItemRemoveButtonComponent**
+- Provides item removal functionality
+- Manages busy state during removal
+- Reloads cart resource after successful removal
+
+**CompleteOrderButtonComponent**
+- Orchestrates checkout completion
+- Validates customer, payer, and shipping address
+- Creates orders via CheckoutCompletionOrchestratorService
+- Manages loading and disabled states
+
+## Component API Reference
+
+### RewardShoppingCartComponent
+
+Root component for the reward shopping cart feature.
+
+**Selector:** `checkout-reward-shopping-cart`
+
+**Providers:**
+- `SelectedRewardShoppingCartResource` - Manages reward cart data
+- `SelectedCustomerResource` - Provides customer information
+- `SelectedCustomerBonusCardsResource` - Provides bonus card data
+
+**Usage:**
+```typescript
+// Loaded via routing - see Quick Start
+```
+
+**Template Structure:**
+```html
+<tabs-navigate-back-button></tabs-navigate-back-button>
+<div><!-- Header with instructions --></div>
+<checkout-customer-reward-card></checkout-customer-reward-card>
+<checkout-billing-and-shipping-address-card></checkout-billing-and-shipping-address-card>
+<checkout-reward-shopping-cart-items></checkout-reward-shopping-cart-items>
+<checkout-complete-order-button></checkout-complete-order-button>
+```
+
+---
+
+### CheckoutCustomerRewardCardComponent
+
+Displays customer loyalty points and redemption summary.
+
+**Selector:** `checkout-customer-reward-card`
+
+**Computed Properties:**
+- `customerName(): string` - Customer full name or "Kein Kunde ausgewählt"
+- `bonusCardPoints(): number` - Total points on primary bonus card
+- `selectedItems(): number` - Number of items in cart
+- `totalPointsRequired(): number` - Sum of loyalty points for all items
+- Remaining points displayed as: `bonusCardPoints() - totalPointsRequired()`
+
+**Usage:**
+```typescript
+// Automatically rendered in RewardShoppingCartComponent
+```
+
+**Display Example:**
+```
+┌─────────────────────────────────────────────────┐
+│ Max Mustermann              │ 1500 Lesepunkte   │
+│ Prämien ausgewählt          │ 3                 │
+│ Prämienkosten               │ 750 Lesepunkte    │
+│ Verbleibende Lesepunkte     │ 750 Lesepunkte    │
+└─────────────────────────────────────────────────┘
+```
+
+---
+
+### BillingAndShippingAddressCardComponent
+
+Displays and manages billing and shipping addresses.
+
+**Selector:** `checkout-billing-and-shipping-address-card`
+
+**Computed Properties:**
+- `customer()` - Current customer from resource
+- `payer()` - Same as customer (billing entity)
+- `payerName(): string` - Formatted customer name
+- `payerAddress()` - Customer billing address
+- `shippingAddress()` - Same as customer (for display)
+- `shippingName(): string` - Formatted shipping name
+- `shippingAddressAddress()` - Customer shipping address
+
+**Methods:**
+- `async navigateToCustomer(): Promise<void>` - Navigates to customer details with preserved return context
+
+**Usage:**
+```html
+<checkout-billing-and-shipping-address-card></checkout-billing-and-shipping-address-card>
+```
+
+**Navigation Behavior:**
+```typescript
+// Navigates to: /{tabId}/customer/search/{customerId}
+// Preserves return URL: /{tabId}/reward/cart
+// Context key: 'select-customer'
+```
+
+---
+
+### RewardShoppingCartItemsComponent
+
+Container component for rendering shopping cart items.
+
+**Selector:** `checkout-reward-shopping-cart-items`
+
+**Computed Properties:**
+- `items(): ShoppingCartItem[]` - Filtered cart items with valid product data
+
+**Filtering Logic:**
+```typescript
+items = computed(() => {
+  const cart = this.#rewardShoppingCartResource.resource.value();
+  return cart?.items
+    ?.map(item => item.data!)
+    .filter(item => item.product != null) ?? [];
+});
+```
+
+**Usage:**
+```html
+<checkout-reward-shopping-cart-items></checkout-reward-shopping-cart-items>
+```
+
+**Deferred Rendering:**
+```html
+@for (item of items(); track item.id) {
+  @defer (on viewport) {
+    <checkout-reward-shopping-cart-item [item]="item"></checkout-reward-shopping-cart-item>
+  } @placeholder {
+    <div>Item</div>
+  }
+}
+```
+
+---
+
+### RewardShoppingCartItemComponent
+
+Individual shopping cart item display with quantity and removal controls.
+
+**Selector:** `checkout-reward-shopping-cart-item`
+
+**Inputs:**
+- `item: WritableSignal<ShoppingCartItem>` - Required. Shopping cart item data
+
+**Properties:**
+- `isBusy: WritableSignal<boolean>` - Busy state for operations
+- `isHorizontal: Signal<boolean>` - Responsive layout flag (desktop = horizontal)
+- `itemId: Signal<number | undefined>` - Computed item ID
+- `shoppingCartId: Signal<number | undefined>` - Computed cart ID
+
+**Methods:**
+- `async updatePurchaseOption(): Promise<void>` - Opens purchase options modal
+
+**Usage:**
+```html
+<checkout-reward-shopping-cart-item
+  [item]="cartItem"
+></checkout-reward-shopping-cart-item>
+```
+
+**Responsive Behavior:**
+```typescript
+// Desktop (≥1440px): Horizontal layout with inline destination info
+isHorizontal = breakpoint([Breakpoint.DesktopL, Breakpoint.DesktopXL]);
+
+// Tablet/Mobile (<1440px): Vertical layout with stacked destination info
+```
+
+**Stock Warning:**
+```html
+<!-- Shown when maxQuantity < 2 -->
+@if (quantityControl.maxQuantity() < 2) {
+  <div class="text-isa-accent-red">
+    Geringer Bestand - Artikel holen vor Abschluss
+  </div>
+}
+```
+
+---
+
+### RewardShoppingCartItemQuantityControlComponent
+
+Manages item quantity with automatic availability validation.
+
+**Selector:** `checkout-reward-shopping-cart-item-quantity-control`
+
+**Export As:** `checkoutRewardShoppingCartItemQuantityControl`
+
+**Inputs:**
+- `item: WritableSignal<ShoppingCartItem>` - Required. Shopping cart item
+
+**Properties:**
+- `isBusy: WritableSignal<boolean>` - Busy state during updates
+- `quantity: LinkedSignal<number>` - Two-way bound quantity
+- `maxQuantity: Signal<number>` - Computed max based on availability
+- `orderType: Signal<OrderType>` - Computed from item features
+- `availabilityResource: Resource<Availability>` - Reactive availability loader
+
+**Max Quantity Logic:**
+```typescript
+maxQuantity = computed(() => {
+  const orderType = this.orderType();
+
+  // Shipping orders: virtually unlimited
+  if (orderType === OrderType.Delivery ||
+      orderType === OrderType.DigitalShipping ||
+      orderType === OrderType.B2BShipping) {
+    return 999;
+  }
+
+  // Pickup/InStore: limited by actual stock
+  return this.availabilityResource.value()?.qty ?? 999;
+});
+```
+
+**Automatic Updates:**
+```typescript
+// Updates shopping cart when quantity changes
+updateQuantityEffect = effect(() => {
+  const originalQuantity = item?.quantity ?? 0;
+  const newQuantity = this.quantity();
+
+  if (originalQuantity !== newQuantity && !isBusy && !isLoading && availability) {
+    // Performs update with price override to 0 (redemption item)
+    await this.performUpdate(newQuantity, availability);
+  }
+});
+```
+
+**Usage:**
+```html
+<checkout-reward-shopping-cart-item-quantity-control
+  #quantityControl="checkoutRewardShoppingCartItemQuantityControl"
+  [item]="cartItem"
+></checkout-reward-shopping-cart-item-quantity-control>
+
+<!-- Access maxQuantity from parent -->
+@if (quantityControl.maxQuantity() < 2) {
+  <div>Low stock warning</div>
+}
+```
+
+**E2E Attributes:**
+```html
+<shared-quantity-control
+  [attr.data-product-id]="catalogProductNumber()"
+  [attr.data-item-id]="item().id"
+></shared-quantity-control>
+```
+
+---
+
+### RewardShoppingCartItemRemoveButtonComponent
+
+Provides item removal functionality with optimistic updates.
+
+**Selector:** `checkout-reward-shopping-cart-item-remove-button`
+
+**Inputs:**
+- `item: WritableSignal<ShoppingCartItem>` - Required. Shopping cart item
+- `isBusy: ModelSignal<boolean>` - Required. Two-way bound busy state
+
+**Properties:**
+- `itemId: Signal<number | undefined>` - Computed item ID
+- `shoppingCartId: Signal<number | undefined>` - Computed cart ID
+
+**Methods:**
+- `async remove(): Promise<void>` - Removes item from shopping cart
+
+**Usage:**
+```html
+<checkout-reward-shopping-cart-item-remove-button
+  [item]="cartItem"
+  [(isBusy)]="isBusy"
+></checkout-reward-shopping-cart-item-remove-button>
+```
+
+**E2E Attributes:**
+```html
+<ui-icon-button
+  [attr.data-what]="'remove-shopping-cart-item-button'"
+  [attr.data-which]="item().id"
+  [attr.data-product-id]="item().product.catalogProductNumber"
+></ui-icon-button>
+```
+
+**Removal Flow:**
+```typescript
+async remove() {
+  // Guard checks
+  if (this.isBusy() || !shoppingCartId || !itemId) return;
+
+  this.isBusy.set(true);
+
+  try {
+    // Remove via facade
+    await this.#shoppingCartFacade.removeItem({ shoppingCartId, shoppingCartItemId });
+
+    // Reload cart resource
+    this.#rewardShoppingCartResource.reload();
+  } catch (error) {
+    this.#logger.error('Error removing item', error);
+  } finally {
+    this.isBusy.set(false);
+  }
+}
+```
+
+---
+
+### CompleteOrderButtonComponent
+
+Orchestrates checkout completion and order creation.
+
+**Selector:** `checkout-complete-order-button`
+
+**Properties:**
+- `isBusy: WritableSignal<boolean>` - Busy state during completion
+- `isCompleted: WritableSignal<boolean>` - Completion status flag
+- `isLoading: Signal<boolean>` - Combined loading state
+- `isDisabled: Signal<boolean>` - Disabled state (busy OR completed OR loading)
+- `shippingAddress: Signal<ShippingAddress | null>` - Selected shipping address from CRM
+- `payer: Signal<Payer | null>` - Selected payer from CRM
+- `shoppingCartId: Signal<number | null>` - Reward cart ID from metadata
+
+**Methods:**
+- `async complete(): Promise<void>` - Completes checkout and creates orders
+
+**Providers:**
+- `CheckoutCompletionOrchestratorService` - Component-level orchestrator instance
+
+**Usage:**
+```html
+<checkout-complete-order-button
+  class="fixed bottom-6 right-6"
+></checkout-complete-order-button>
+```
+
+**Button States:**
+```html
+<button
+  uiButton
+  color="brand"
+  size="large"
+  [disabled]="isDisabled()"
+  [pending]="isLoading()"
+  (click)="complete()"
+>
+  Abschließen
+</button>
+```
+
+**Completion Flow:**
+```typescript
+async complete() {
+  // Validation
+  if (isDisabled()) return;
+  if (!shoppingCartId) throw new Error('Missing shopping cart ID');
+  if (!customer) throw new Error('Missing customer data');
+
+  // Complete via orchestrator
+  const orders = await this.#orchestrator.completeCheckoutAndCreateOrders({
+    shoppingCartId,
+    crmCustomer: customer,
+    crmShippingAddress: shippingAddress ?? undefined,
+    crmPayer: payer ?? undefined,
+    notificationChannels: customer.notificationChannels ?? 0,
+  });
+
+  // Mark as completed
+  this.isCompleted.set(true);
+}
+```
+
+## Usage Examples
+
+### Basic Setup with Routing
+
+```typescript
+// app-routing.module.ts
+import { Routes } from '@angular/router';
+import { routes as rewardCartRoutes } from '@isa/checkout/feature/reward-shopping-cart';
+
+export const routes: Routes = [
+  {
+    path: ':tabId/reward/cart',
+    loadChildren: () => rewardCartRoutes,
+  },
+];
+```
+
+### Navigating to Reward Cart
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router } from '@angular/router';
+import { TabService } from '@isa/core/tabs';
+
+@Component({
+  selector: 'app-reward-selection',
+  template: `
+    <button (click)="viewCart()">
+      Warenkorb anzeigen
+    </button>
+  `
+})
+export class RewardSelectionComponent {
+  #router = inject(Router);
+  #tabService = inject(TabService);
+
+  async viewCart(): Promise<void> {
+    const tabId = this.#tabService.activatedTabId();
+    await this.#router.navigate(['/', tabId, 'reward', 'cart']);
+  }
+}
+```
+
+### Adding Items to Reward Cart
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { ShoppingCartFacade } from '@isa/checkout/data-access';
+import { TabService } from '@isa/core/tabs';
+
+@Component({
+  selector: 'app-product-detail',
+  template: '...'
+})
+export class ProductDetailComponent {
+  #shoppingCartFacade = inject(ShoppingCartFacade);
+  #tabService = inject(TabService);
+
+  async addToRewardCart(
+    productId: number,
+    loyaltyPoints: number
+  ): Promise<void> {
+    const tabId = this.#tabService.activatedTabId();
+
+    if (!tabId) {
+      throw new Error('No active tab');
+    }
+
+    // Add item to reward cart (creates cart if needed)
+    await this.#shoppingCartFacade.addItemsToShoppingCart({
+      tabId,
+      items: [{
+        catalogProductNumber: productId,
+        rewardCartQuantity: 1, // Quantity for reward cart
+        cartQuantity: 0,       // Not added to regular cart
+        itemFeatures: {
+          orderType: 'Versand',
+          // ... other features
+        }
+      }]
+    });
+  }
+}
+```
+
+### Checking Reward Cart Status
+
+```typescript
+import { Component, inject, computed } from '@angular/core';
+import { CheckoutMetadataService } from '@isa/checkout/data-access';
+import { TabService } from '@isa/core/tabs';
+
+@Component({
+  selector: 'app-header',
+  template: `
+    @if (hasRewardCart()) {
+      <button (click)="viewCart()">
+        Reward Cart: {{ itemCount() }} items
+      </button>
+    }
+  `
+})
+export class HeaderComponent {
+  #checkoutMetadata = inject(CheckoutMetadataService);
+  #tabService = inject(TabService);
+
+  hasRewardCart = computed(() => {
+    const tabId = this.#tabService.activatedTabId();
+    return tabId
+      ? !!this.#checkoutMetadata.getRewardShoppingCartId(tabId)
+      : false;
+  });
+
+  // Note: To get item count, you'd need to fetch the full cart
+  // via SelectedRewardShoppingCartResource
+}
+```
+
+### Custom Item Rendering
+
+```typescript
+import { Component, input } from '@angular/core';
+import { ShoppingCartItem } from '@isa/checkout/data-access';
+
+@Component({
+  selector: 'app-custom-cart-item',
+  template: `
+    <div class="cart-item">
+      <h3>{{ item().product.name }}</h3>
+      <p>Points: {{ item().loyalty.value }}</p>
+      <p>Quantity: {{ item().quantity }}</p>
+
+      <!-- Use standard quantity control -->
+      <checkout-reward-shopping-cart-item-quantity-control
+        [item]="item"
+      ></checkout-reward-shopping-cart-item-quantity-control>
+
+      <!-- Use standard remove button -->
+      <checkout-reward-shopping-cart-item-remove-button
+        [item]="item"
+        [(isBusy)]="isBusy"
+      ></checkout-reward-shopping-cart-item-remove-button>
+    </div>
+  `
+})
+export class CustomCartItemComponent {
+  item = input.required<ShoppingCartItem>();
+  isBusy = signal(false);
+}
+```
+
+### Handling Completion Events
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router } from '@angular/router';
+import { CheckoutCompletionOrchestratorService } from '@isa/checkout/feature/reward-shopping-cart';
+
+@Component({
+  selector: 'app-custom-complete-button',
+  template: `
+    <button
+      (click)="complete()"
+      [disabled]="isCompleted()"
+    >
+      {{ isCompleted() ? 'Completed' : 'Complete Order' }}
+    </button>
+  `,
+  providers: [CheckoutCompletionOrchestratorService]
+})
+export class CustomCompleteButtonComponent {
+  #orchestrator = inject(CheckoutCompletionOrchestratorService);
+  #router = inject(Router);
+
+  isCompleted = signal(false);
+
+  async complete(): Promise<void> {
+    try {
+      const orders = await this.#orchestrator.completeCheckoutAndCreateOrders({
+        shoppingCartId: 123,
+        crmCustomer: customer,
+        crmShippingAddress: address,
+        crmPayer: payer,
+        notificationChannels: 1,
+      });
+
+      this.isCompleted.set(true);
+
+      // Navigate to order confirmation
+      await this.#router.navigate(['/reward/order-confirmation', orders[0].id]);
+    } catch (error) {
+      console.error('Completion failed', error);
+    }
+  }
+}
+```
+
+## Routing and Navigation
+
+### Route Definition
+
+```typescript
+// libs/checkout/feature/reward-shopping-cart/src/lib/routes.ts
+import { Routes } from '@angular/router';
+import { RewardShoppingCartComponent } from './reward-shopping-cart.component';
+
+export const routes: Routes = [
+  {
+    path: '',
+    component: RewardShoppingCartComponent,
+  },
+];
+```
+
+### Integration with App Routes
+
+```typescript
+// app-routing.module.ts
+const routes: Routes = [
+  {
+    path: ':tabId/reward/cart',
+    loadChildren: () => import('@isa/checkout/feature/reward-shopping-cart').then(m => m.routes),
+  },
+];
+```
+
+### Navigation Patterns
+
+#### From Product List to Cart
+
+```typescript
+// Navigate to reward cart
+await this.router.navigate(['/', tabId, 'reward', 'cart']);
+```
+
+#### Back Navigation
+
+```typescript
+// Uses NavigateBackButtonComponent (automatically handles tab history)
+<tabs-navigate-back-button></tabs-navigate-back-button>
+```
+
+#### To Customer Details (Preserving Context)
+
+```typescript
+// BillingAndShippingAddressCardComponent does this automatically
+async navigateToCustomer() {
+  const returnUrl = `/${this.tabId()}/reward/cart`;
+
+  await this.#navigationState.navigateWithPreservedContext(
+    ['/', 'kunde', this.tabId(), 'customer', 'search', customerId],
+    { returnUrl },
+    'select-customer',
+  );
+}
+```
+
+#### After Order Completion
+
+```typescript
+// Typically navigates to order confirmation (implement in your app)
+await this.router.navigate([
+  '/',
+  tabId,
+  'reward',
+  'order-confirmation',
+  orderId
+]);
+```
+
+## Shopping Cart Management
+
+### Cart Creation
+
+Reward shopping carts are created automatically when adding the first item:
+
+```typescript
+// ShoppingCartService.addItemsToShoppingCart()
+const rewardCartId = await this.#getOrCreateRewardShoppingCartId(tabId);
+```
+
+### Cart Metadata
+
+Cart IDs are stored per-tab in `CheckoutMetadataService`:
+
+```typescript
+// Get reward cart ID
+const cartId = checkoutMetadataService.getRewardShoppingCartId(tabId);
+
+// Set reward cart ID (usually done automatically)
+checkoutMetadataService.setRewardShoppingCartId(tabId, cartId);
+```
+
+### Cart Resource Loading
+
+`SelectedRewardShoppingCartResource` automatically loads cart data based on active tab:
+
+```typescript
+@Injectable()
+export class SelectedRewardShoppingCartResource extends ShoppingCartResource {
+  constructor() {
+    super();
+
+    // Automatically updates when tab changes
+    effect(() => {
+      const tabId = this.#tabId();
+      const shoppingCartId = tabId
+        ? this.#checkoutMetadata.getRewardShoppingCartId(tabId)
+        : undefined;
+
+      this.params({ shoppingCartId });
+    });
+  }
+}
+```
+
+### Adding Items
+
+```typescript
+await shoppingCartFacade.addItemsToShoppingCart({
+  tabId,
+  items: [{
+    catalogProductNumber: productId,
+    rewardCartQuantity: 1,  // Adds to reward cart
+    cartQuantity: 0,         // Does NOT add to regular cart
+    itemFeatures: {
+      orderType: 'Versand',
+      // ... availability and pricing info
+    }
+  }]
+});
+```
+
+### Updating Quantity
+
+```typescript
+// Done automatically by RewardShoppingCartItemQuantityControlComponent
+await shoppingCartFacade.updateItem({
+  shoppingCartId,
+  shoppingCartItemId,
+  values: {
+    quantity: newQuantity,
+    availability: updatedAvailability,
+  }
+});
+```
+
+### Removing Items
+
+```typescript
+// Done by RewardShoppingCartItemRemoveButtonComponent
+await shoppingCartFacade.removeItem({
+  shoppingCartId,
+  shoppingCartItemId,
+});
+```
+
+### Reloading Cart Data
+
+```typescript
+// After any mutation, reload the resource
+this.#rewardShoppingCartResource.reload();
+```
+
+## Checkout Workflow
+
+### Complete Workflow Steps
+
+1. **Customer Selection** (prerequisite)
+   - Customer must be selected via CRM tab metadata
+   - Bonus card data loaded automatically
+
+2. **Item Selection** (prerequisite)
+   - Items added to reward cart via RewardSelectionDialog
+   - Each item has loyalty points cost
+
+3. **Cart Review** (this feature)
+   - View all selected items
+   - Adjust quantities
+   - Remove items if needed
+   - View loyalty points balance
+
+4. **Address Verification**
+   - Review billing/shipping addresses
+   - Edit addresses via customer details if needed
+   - Return to cart after editing
+
+5. **Order Completion**
+   - Click "Abschließen" button
+   - Validates customer, payer, shipping address
+   - Completes checkout via orchestrator
+   - Creates orders in OMS
+   - Navigates to confirmation (if implemented)
+
+### CheckoutCompletionOrchestratorService
+
+This service coordinates the final checkout steps:
+
+```typescript
+@Injectable()
+export class CheckoutCompletionOrchestratorService {
+  /**
+   * Complete checkout with CRM data and create orders.
+   *
+   * @param params - CRM-sourced checkout parameters
+   * @param abortSignal - Optional cancellation signal
+   * @returns Created orders
+   */
+  async completeCheckoutAndCreateOrders(
+    params: CompleteCrmOrderParams,
+    abortSignal?: AbortSignal,
+  ): Promise<Order[]> {
+    // Step 1: Complete checkout with CRM data transformation
+    const orders = await this.#shoppingCartFacade.completeWithCrmData(
+      params,
+      abortSignal,
+    );
+
+    return orders;
+  }
+}
+```
+
+### Orchestrator Responsibilities
+
+1. **Data Transformation**
+   - Converts CRM customer to checkout format
+   - Adapts shipping address structure
+   - Transforms payer information
+
+2. **Checkout Completion**
+   - Calls checkout API with transformed data
+   - Validates all required fields
+   - Handles API errors
+
+3. **Order Creation**
+   - Automatically creates orders in OMS
+   - Returns order references
+
+4. **Error Handling**
+   - Logs all steps
+   - Provides unified error handling
+   - Rethrows errors for component handling
+
+### Architectural Note: Feature vs Data-Access
+
+The orchestrator lives in the **feature layer** (not data-access) because:
+
+- **Cross-domain coordination**: Combines checkout + OMS + CRM
+- **Business workflow**: Specific to reward checkout use case
+- **Facade independence**: Prevents circular dependencies between domain facades
+- **Component coupling**: Tightly coupled to UI workflow
+
+This demonstrates proper architectural layering:
+- **Feature layer**: Orchestrates cross-domain workflows
+- **Data-access facades**: Focus on single-domain operations
+- **Services**: Don't depend on other domain facades
+
+## State Management
+
+### Resource-Based State
+
+The library uses Angular's `resource()` API for reactive data loading:
+
+```typescript
+readonly resource = resource({
+  params: () => this.#params(),
+  loader: ({ params, abortSignal }) =>
+    params?.shoppingCartId
+      ? this.#shoppingCartService.getShoppingCart(params.shoppingCartId, abortSignal)
+      : Promise.resolve(null),
+});
+```
+
+### Automatic Resource Updates
+
+Resources automatically reload when parameters change:
+
+```typescript
+// Tab change triggers parameter update
+effect(() => {
+  const tabId = this.#tabId();
+  const shoppingCartId = tabId
+    ? this.#checkoutMetadata.getRewardShoppingCartId(tabId)
+    : undefined;
+
+  this.params({ shoppingCartId }); // Triggers resource reload
+});
+```
+
+### Manual Resource Reloading
+
+After mutations, manually reload resources:
+
+```typescript
+// After removing item
+await this.#shoppingCartFacade.removeItem({ ... });
+this.#rewardShoppingCartResource.reload();
+
+// After updating quantity
+await this.#shoppingCartFacade.updateItem({ ... });
+this.#rewardShoppingCartResource.reload();
+```
+
+### Computed State
+
+Derive UI state from resource values:
+
+```typescript
+selectedItems = computed(() => {
+  const cart = this.#shoppingCartResource.value();
+  return cart?.items?.length ?? 0;
+});
+
+totalPointsRequired = computed(() => {
+  const cart = this.#shoppingCartResource.value();
+  if (!cart?.items?.length) return 0;
+
+  const loyalty = cart.items.map(i => i.data?.loyalty?.value ?? 0);
+  return loyalty.reduce((a, b) => a + b, 0);
+});
+```
+
+### Busy State Management
+
+Components coordinate busy states for smooth UX:
+
+```typescript
+// Parent component
+isBusy = signal(false);
+
+// Child components share busy state
+<checkout-reward-shopping-cart-item-quantity-control
+  [item]="item"
+  [isBusy]="isBusy"
+></checkout-reward-shopping-cart-item-quantity-control>
+
+<checkout-reward-shopping-cart-item-remove-button
+  [item]="item"
+  [(isBusy)]="isBusy"
+></checkout-reward-shopping-cart-item-remove-button>
+```
+
+## Architecture Notes
+
+### Current Architecture
+
+The library follows a feature-layer architecture with clear separation:
+
+```
+Feature Layer (This Library)
+       ↓
+├─ RewardShoppingCartComponent (UI coordination)
+├─ Child Components (Specialized UI)
+├─ CheckoutCompletionOrchestratorService (Cross-domain workflow)
+       ↓
+Data Access Layer (Dependencies)
+├─ @isa/checkout/data-access
+│  ├─ SelectedRewardShoppingCartResource (Cart data)
+│  ├─ ShoppingCartFacade (Cart operations)
+│  └─ CheckoutMetadataService (Tab metadata)
+├─ @isa/crm/data-access
+│  ├─ SelectedCustomerResource (Customer data)
+│  ├─ SelectedCustomerBonusCardsResource (Bonus cards)
+│  └─ CrmTabMetadataService (CRM metadata)
+├─ @isa/oms/data-access
+│  └─ OrderCreationFacade (Order creation)
+└─ @isa/availability/data-access
+   └─ AvailabilityFacade (Stock checking)
+```
+
+### Design Patterns
+
+#### 1. Resource Pattern
+
+Uses Angular `resource()` for declarative data loading:
+
+**Benefits:**
+- Automatic loading/reloading
+- Built-in abort signal support
+- Loading state management
+- Parameter reactivity
+
+**Example:**
+```typescript
+availabilityResource = resource<Availability, GetSingleItemAvailabilityInputParams>({
+  params: () => ({
+    orderType: this.orderType(),
+    item: {
+      itemId: this.item().id,
+      quantity: this.quantity(), // Reactive - triggers reload
+    }
+  }),
+  loader: async ({ params, abortSignal }) => {
+    return await this.#availabilityFacade.getAvailability(params, abortSignal);
+  }
+});
+```
+
+#### 2. Orchestrator Pattern
+
+`CheckoutCompletionOrchestratorService` demonstrates proper orchestration:
+
+**Responsibilities:**
+- Coordinate cross-domain operations
+- Provide unified error handling
+- Manage complex workflows
+
+**Why Not in Data-Access:**
+- Prevents circular dependencies between facades
+- Specific to feature workflow
+- Tightly coupled to UI needs
+
+#### 3. Provider Scoping
+
+Component-level providers for proper lifecycle:
+
+```typescript
+@Component({
+  selector: 'checkout-reward-shopping-cart',
+  providers: [
+    SelectedRewardShoppingCartResource,
+    SelectedCustomerResource,
+    SelectedCustomerBonusCardsResource,
+  ],
+})
+export class RewardShoppingCartComponent {}
+```
+
+**Benefits:**
+- Fresh resource instances per component
+- Automatic cleanup on component destroy
+- Isolated state per tab
+
+#### 4. Reactive Breakpoints
+
+Responsive layout using breakpoint service:
+
+```typescript
+import { breakpoint, Breakpoint } from '@isa/ui/layout';
+
+isHorizontal = breakpoint([
+  Breakpoint.DesktopL,
+  Breakpoint.DesktopXL,
+]);
+```
+
+**Benefits:**
+- Server-side rendering compatible
+- Reactive breakpoint changes
+- Consistent with project standards
+
+### Known Architectural Considerations
+
+#### 1. Quantity Control Complexity (High Priority)
+
+**Current State:**
+- 320-line component with multiple responsibilities
+- Reactive resource + effect for quantity changes
+- Price transformation logic embedded
+
+**TODO Comments Identified:**
+```typescript
+// TODO: [Complexity Reduction - Critical Priority]
+// Replace reactive pattern with debounced manual fetch
+// Effort: ~3 hours | Impact: High
+
+// TODO: [Complexity Reduction - Critical Priority]
+// Extract price transformation to RewardPriceTransformer service
+// Effort: ~4 hours | Impact: High
+
+// TODO: [Performance Optimization - Medium Priority]
+// Remove redundant computed signals
+// Effort: ~1-2 hours | Impact: Medium
+```
+
+**Proposed Refactoring:**
+1. Replace effect + resource with debounced async method
+2. Extract price transformation to service
+3. Reduce signal overhead
+
+#### 2. Missing Test Coverage (High Priority)
+
+**Current State:**
+- Zero test files for feature components
+- TODO comments reference missing tests
+
+**TODO Comments Identified:**
+```typescript
+// RewardShoppingCartItemComponent:
+// TODO: [Next Sprint - Medium Priority] Create test file
+
+// RewardShoppingCartItemQuantityControlComponent:
+// TODO: [Next Sprint - High Priority] Create comprehensive test file
+// Coverage target: >80%
+
+// RewardShoppingCartItemRemoveButtonComponent:
+// TODO: [Next Sprint - Medium Priority] Create test file
+```
+
+**Recommended Approach:**
+- Use Vitest + Angular Testing Utilities (per project standards)
+- Cover critical business logic first (quantity control, orchestrator)
+- Add E2E attribute validation tests
+
+#### 3. Customer Address Duplication (Low Priority)
+
+**Current State:**
+BillingAndShippingAddressCardComponent shows same address twice:
+
+```typescript
+payer = computed(() => this.customer());
+shippingAddress = computed(() => this.customer());
+```
+
+**Consideration:**
+- May be intentional (rewards always ship to customer)
+- Consider hiding one section if addresses are identical
+- Low priority unless UX feedback indicates confusion
+
+### Performance Considerations
+
+1. **Deferred Rendering**
+   - Items load on viewport intersection
+   - Reduces initial render time for large carts
+
+2. **Reactive Availability**
+   - Availability checks only on quantity change
+   - AbortSignal cancels in-flight requests
+
+3. **Resource Caching**
+   - Resources don't reload unless params change
+   - Manual reloads only after mutations
+
+4. **Breakpoint Service**
+   - Efficient media query matching
+   - Avoids CSS-only solutions that SSR poorly
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Navigation Enhancement**
+   - Navigate to order confirmation after completion
+   - Currently just marks as completed (no navigation)
+
+2. **Error Presentation**
+   - User-friendly error messages for completion failures
+   - Currently only logs errors (no UI feedback)
+
+3. **Loading States**
+   - Skeleton loaders for better perceived performance
+   - Currently shows placeholder text ("Item")
+
+4. **Accessibility**
+   - ARIA labels for screen readers
+   - Keyboard navigation support
+
+5. **Analytics Integration**
+   - Track completion rate
+   - Monitor cart abandonment
+
+## Dependencies
+
+### Required Libraries
+
+**Angular Core:**
+- `@angular/core` - Angular framework
+- `@angular/router` - Routing support
+- `@angular/forms` - FormsModule for ngModel
+
+**ISA Libraries:**
+- `@isa/checkout/data-access` - Shopping cart and checkout services
+- `@isa/checkout/shared/product-info` - Product display components
+- `@isa/checkout/shared/reward-selection-dialog` - Reward selection trigger
+- `@isa/crm/data-access` - Customer and bonus card services
+- `@isa/oms/data-access` - Order creation services
+- `@isa/availability/data-access` - Availability checking
+- `@isa/core/tabs` - Tab management
+- `@isa/core/navigation` - Navigation state service
+- `@isa/core/logging` - Logging service
+- `@isa/ui/buttons` - Button components
+- `@isa/ui/layout` - Breakpoint service
+- `@isa/shared/address` - Address display component
+- `@isa/shared/quantity-control` - Quantity control component
+- `@isa/icons` - Icon library
+
+**Third-Party:**
+- `@ng-icons/core` - Icon rendering
+
+### Path Alias
+
+Import from: `@isa/checkout/feature/reward-shopping-cart`
+
+### Peer Dependencies
+
+Ensure these are available in your application:
+
+- Node.js ≥22.0.0
+- npm ≥10.0.0
+- Angular 20.1.2
+- TypeScript 5.8.3
+
+## Testing
+
+The library uses **Vitest** with **Angular Testing Utilities** for testing (per project standards).
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test checkout-feature-reward-shopping-cart --skip-nx-cache
+
+# Run tests with coverage
+npx nx test checkout-feature-reward-shopping-cart --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test checkout-feature-reward-shopping-cart --watch
+```
+
+### Current Test Coverage
+
+**Status:** No test files currently exist (Feature in development)
+
+**TODO Items:**
+- RewardShoppingCartItemComponent tests (Medium Priority)
+- RewardShoppingCartItemQuantityControlComponent tests (High Priority - >80% coverage target)
+- RewardShoppingCartItemRemoveButtonComponent tests (Medium Priority)
+- CheckoutCompletionOrchestratorService tests (High Priority)
+
+### Testing Recommendations
+
+#### Component Testing Pattern
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { signal } from '@angular/core';
+import { RewardShoppingCartItemComponent } from './reward-shopping-cart-item.component';
+
+describe('RewardShoppingCartItemComponent', () => {
+  let component: RewardShoppingCartItemComponent;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      imports: [RewardShoppingCartItemComponent],
+      providers: [
+        // Mock providers
+        { provide: SelectedRewardShoppingCartResource, useValue: mockResource },
+        { provide: PurchaseOptionsModalService, useValue: mockModalService },
+      ]
+    });
+
+    const fixture = TestBed.createComponent(RewardShoppingCartItemComponent);
+    component = fixture.componentInstance;
+    fixture.componentRef.setInput('item', mockItem);
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+
+  it('should open purchase options modal', async () => {
+    await component.updatePurchaseOption();
+    expect(mockModalService.open).toHaveBeenCalled();
+  });
+});
+```
+
+#### Service Testing Pattern
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { CheckoutCompletionOrchestratorService } from './checkout-completion-orchestrator.service';
+
+describe('CheckoutCompletionOrchestratorService', () => {
+  let service: CheckoutCompletionOrchestratorService;
+  let mockShoppingCartFacade: any;
+
+  beforeEach(() => {
+    mockShoppingCartFacade = {
+      completeWithCrmData: vi.fn().mockResolvedValue([{ id: 1 }])
+    };
+
+    TestBed.configureTestingModule({
+      providers: [
+        CheckoutCompletionOrchestratorService,
+        { provide: ShoppingCartFacade, useValue: mockShoppingCartFacade },
+      ]
+    });
+
+    service = TestBed.inject(CheckoutCompletionOrchestratorService);
+  });
+
+  it('should complete checkout and create orders', async () => {
+    const orders = await service.completeCheckoutAndCreateOrders({
+      shoppingCartId: 123,
+      crmCustomer: mockCustomer,
+    });
+
+    expect(orders).toHaveLength(1);
+    expect(mockShoppingCartFacade.completeWithCrmData).toHaveBeenCalled();
+  });
+});
+```
+
+#### E2E Attribute Testing
+
+```typescript
+it('should have E2E attributes on remove button', () => {
+  const fixture = TestBed.createComponent(RewardShoppingCartItemRemoveButtonComponent);
+  fixture.componentRef.setInput('item', mockItem);
+  fixture.detectChanges();
+
+  const button = fixture.nativeElement.querySelector('button');
+
+  expect(button.getAttribute('data-what')).toBe('remove-shopping-cart-item-button');
+  expect(button.getAttribute('data-which')).toBe(String(mockItem.id));
+  expect(button.getAttribute('data-product-id')).toBe(mockItem.product.catalogProductNumber);
+});
+```
+
+## Best Practices
+
+### 1. Always Validate Prerequisites
+
+Before navigating to the reward cart, ensure:
+
+```typescript
+// ✅ Good: Check prerequisites
+async navigateToRewardCart() {
+  const tabId = this.#tabService.activatedTabId();
+  const customerId = this.#crmMetadata.selectedCustomerId(tabId);
+  const cartId = this.#checkoutMetadata.getRewardShoppingCartId(tabId);
+
+  if (!customerId) {
+    // Show error: "Please select a customer first"
+    return;
+  }
+
+  if (!cartId) {
+    // Show error: "Reward cart is empty"
+    return;
+  }
+
+  await this.router.navigate(['/', tabId, 'reward', 'cart']);
+}
+
+// ❌ Bad: Navigate without checking
+async navigateToRewardCart() {
+  await this.router.navigate(['/', tabId, 'reward', 'cart']);
+  // Will show errors/empty states in cart page
+}
+```
+
+### 2. Use Provided Resources
+
+Always inject provided resources at the component level:
+
+```typescript
+// ✅ Good: Uses provided resource from RewardShoppingCartComponent
+@Component({
+  selector: 'app-custom-child',
+  template: '...'
+})
+export class CustomChildComponent {
+  #cartResource = inject(SelectedRewardShoppingCartResource);
+
+  items = computed(() => this.#cartResource.resource.value()?.items ?? []);
+}
+
+// ❌ Bad: Creates new resource instance
+@Component({
+  selector: 'app-custom-child',
+  providers: [SelectedRewardShoppingCartResource], // Don't do this
+  template: '...'
+})
+export class CustomChildComponent {
+  // Will create separate instance, lose shared state
+}
+```
+
+### 3. Reload Resources After Mutations
+
+Always reload resources after modifying cart data:
+
+```typescript
+// ✅ Good: Reloads resource after mutation
+async removeItem() {
+  await this.#shoppingCartFacade.removeItem({ ... });
+  this.#rewardShoppingCartResource.reload(); // Refresh UI
+}
+
+// ❌ Bad: Forgets to reload
+async removeItem() {
+  await this.#shoppingCartFacade.removeItem({ ... });
+  // UI won't update until next navigation
+}
+```
+
+### 4. Handle Errors Gracefully
+
+Provide user feedback for errors:
+
+```typescript
+// ✅ Good: Logs and shows user feedback
+async complete() {
+  try {
+    const orders = await this.#orchestrator.completeCheckoutAndCreateOrders({ ... });
+    this.#toastService.success('Order completed successfully');
+    await this.router.navigate(['/confirmation', orders[0].id]);
+  } catch (error) {
+    this.#logger.error('Completion failed', error);
+    this.#toastService.error('Failed to complete order. Please try again.');
+  }
+}
+
+// ❌ Bad: Silent failure
+async complete() {
+  try {
+    await this.#orchestrator.completeCheckoutAndCreateOrders({ ... });
+  } catch (error) {
+    // User has no idea what happened
+  }
+}
+```
+
+### 5. Use E2E Testing Attributes
+
+Always include data-* attributes for QA testing:
+
+```html
+<!-- ✅ Good: Has E2E attributes -->
+<button
+  (click)="remove()"
+  [attr.data-what]="'remove-shopping-cart-item-button'"
+  [attr.data-which]="item().id"
+  [attr.data-product-id]="item().product.catalogProductNumber"
+>
+  Remove
+</button>
+
+<!-- ❌ Bad: No E2E attributes -->
+<button (click)="remove()">
+  Remove
+</button>
+```
+
+### 6. Coordinate Busy States
+
+Share busy states between related components:
+
+```typescript
+// ✅ Good: Shared busy state prevents double-clicks
+<checkout-reward-shopping-cart-item-quantity-control
+  [item]="item"
+></checkout-reward-shopping-cart-item-quantity-control>
+
+<checkout-reward-shopping-cart-item-remove-button
+  [item]="item"
+  [(isBusy)]="isBusy"  // Shared with parent
+></checkout-reward-shopping-cart-item-remove-button>
+
+// Parent manages overall busy state
+async updatePurchaseOption() {
+  if (this.isBusy()) return; // Guards against concurrent operations
+  this.isBusy.set(true);
+  // ...
+}
+```
+
+### 7. Use Breakpoint Service for Responsive Design
+
+Prefer the breakpoint service over CSS-only solutions:
+
+```typescript
+// ✅ Good: SSR-compatible, reactive
+import { breakpoint, Breakpoint } from '@isa/ui/layout';
+
+isHorizontal = breakpoint([Breakpoint.DesktopL, Breakpoint.DesktopXL]);
+
+// Template
+@if (isHorizontal()) {
+  <div class="horizontal-layout">...</div>
+} @else {
+  <div class="vertical-layout">...</div>
+}
+
+// ❌ Bad: CSS-only (SSR issues)
+<div class="hidden isa-desktop:block">...</div>
+<div class="block isa-desktop:hidden">...</div>
+```
+
+### 8. Leverage Deferred Rendering
+
+Use @defer for large lists:
+
+```html
+<!-- ✅ Good: Defers rendering until viewport -->
+@for (item of items(); track item.id) {
+  @defer (on viewport) {
+    <checkout-reward-shopping-cart-item [item]="item"></checkout-reward-shopping-cart-item>
+  } @placeholder {
+    <div>Loading item...</div>
+  }
+}
+
+<!-- ❌ Bad: Renders all items immediately -->
+@for (item of items(); track item.id) {
+  <checkout-reward-shopping-cart-item [item]="item"></checkout-reward-shopping-cart-item>
+}
+```
+
+### 9. Follow Angular Modern Patterns
+
+Use Angular 20+ features:
+
+```typescript
+// ✅ Good: Modern Angular patterns
+@Component({
+  selector: 'app-example',
+  changeDetection: ChangeDetectionStrategy.OnPush, // Always OnPush
+  imports: [...],  // Standalone with explicit imports
+})
+export class ExampleComponent {
+  #service = inject(Service);  // inject() over constructor
+
+  value = input.required<string>();  // input() over @Input()
+  output = output<string>();  // output() over @Output()
+
+  computed = computed(() => this.value().toUpperCase());  // Signals
+}
+
+// ❌ Bad: Legacy patterns
+@Component({
+  selector: 'app-example',
+  // No changeDetection specified (defaults to Default)
+})
+export class ExampleComponent {
+  @Input() value!: string;  // Old decorator syntax
+  @Output() output = new EventEmitter<string>();
+
+  constructor(private service: Service) {}  // Constructor injection
+}
+```
+
+### 10. Document Complex Logic
+
+Add TODO comments for technical debt:
+
+```typescript
+// ✅ Good: Clear TODO with context
+// TODO: [Next Sprint - High Priority] Create comprehensive test file
+// - Test availability resource loading with quantity changes
+// - Test price handling for redemption items (price override to 0)
+// - Coverage target: >80% for this critical business logic component
+
+// TODO: [Performance Optimization - Medium Priority] Replace structuredClone
+// Current: Deep clone on every update (~1-2ms overhead)
+// Target: Shallow spreads only when modifying
+// Effort: ~1 hour | Impact: Medium | Risk: Very Low
+
+// ❌ Bad: Vague TODO
+// TODO: Fix this later
+```
+
+---
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/checkout/feature/reward-shopping-cart/src/lib/complete-order-button/complete-order-button.component.html b/libs/checkout/feature/reward-shopping-cart/src/lib/complete-order-button/complete-order-button.component.html
index 1083e9c90..9a3ecee78 100644
--- a/libs/checkout/feature/reward-shopping-cart/src/lib/complete-order-button/complete-order-button.component.html
+++ b/libs/checkout/feature/reward-shopping-cart/src/lib/complete-order-button/complete-order-button.component.html
@@ -1,3 +1,11 @@
-<button uiButton type="button" color="brand" size="large" (click)="complete()">
+<button
+  uiButton
+  type="button"
+  color="brand"
+  size="large"
+  (click)="complete()"
+  [disabled]="isDisabled()"
+  [pending]="isLoading()"
+>
   Abschließen
 </button>
diff --git a/libs/checkout/feature/reward-shopping-cart/src/lib/complete-order-button/complete-order-button.component.ts b/libs/checkout/feature/reward-shopping-cart/src/lib/complete-order-button/complete-order-button.component.ts
index c3a71c74b..9b6c99f61 100644
--- a/libs/checkout/feature/reward-shopping-cart/src/lib/complete-order-button/complete-order-button.component.ts
+++ b/libs/checkout/feature/reward-shopping-cart/src/lib/complete-order-button/complete-order-button.component.ts
@@ -3,20 +3,18 @@ import {
   Component,
   computed,
   inject,
+  signal,
 } from '@angular/core';
 import { ButtonComponent } from '@isa/ui/buttons';
-import {
-  CheckoutMetadataService,
-  ShoppingCartFacade,
-  CustomerAdapter,
-  ShippingAddressAdapter,
-  PayerAdapter,
-} from '@isa/checkout/data-access';
+import { CheckoutMetadataService } from '@isa/checkout/data-access';
 import {
   SelectedCustomerResource,
   CrmTabMetadataService,
 } from '@isa/crm/data-access';
 import { injectTabId } from '@isa/core/tabs';
+import { logger } from '@isa/core/logging';
+import { CheckoutCompletionOrchestratorService } from '../services';
+import { Router } from '@angular/router';
 
 @Component({
   selector: 'checkout-complete-order-button',
@@ -24,15 +22,25 @@ import { injectTabId } from '@isa/core/tabs';
   styleUrls: ['./complete-order-button.component.css'],
   changeDetection: ChangeDetectionStrategy.OnPush,
   imports: [ButtonComponent],
+  providers: [CheckoutCompletionOrchestratorService],
 })
 export class CompleteOrderButtonComponent {
+  #logger = logger(() => ({
+    component: 'CompleteOrderButtonComponent',
+    tabId: this.#tabId(),
+  }));
   #tabId = injectTabId();
   #tabMetadata = inject(CrmTabMetadataService);
   #checkoutMetadata = inject(CheckoutMetadataService);
 
-  #shoppingCartFacade = inject(ShoppingCartFacade);
+  #orchestrator = inject(CheckoutCompletionOrchestratorService);
   #customerResource = inject(SelectedCustomerResource);
 
+  #router = inject(Router);
+
+  isBusy = signal(false);
+  isCompleted = signal(false);
+
   shippingAddress = computed(() => {
     const tabId = this.#tabId();
     const sa = tabId
@@ -64,8 +72,12 @@ export class CompleteOrderButtonComponent {
     return payers?.find((p) => p?.id === payerId) ?? null;
   });
 
+  isLoading = computed(() => {
+    return this.#customerResource.resource.isLoading() || this.isBusy();
+  });
+
   isDisabled = computed(() => {
-    return this.#customerResource.resource.isLoading();
+    return this.isBusy() || this.isCompleted() || this.isLoading();
   });
 
   shoppingCartId = computed(() => {
@@ -73,59 +85,49 @@ export class CompleteOrderButtonComponent {
     return tabId ? this.#checkoutMetadata.getRewardShoppingCartId(tabId) : null;
   });
 
-  complete() {
+  async complete() {
     if (this.isDisabled()) {
       return;
     }
 
-    const shoppingCartId = this.shoppingCartId();
-    if (!shoppingCartId) {
-      throw new Error('No shopping cart ID available to complete order.');
+    this.isBusy.set(true);
+
+    try {
+      const shoppingCartId = this.shoppingCartId();
+      if (!shoppingCartId) {
+        throw new Error('Missing shopping cart ID');
+      }
+
+      const customer = this.#customerResource.resource.value();
+      if (!customer) {
+        throw new Error('Missing customer data');
+      }
+
+      // Complete order using orchestrator with CRM data
+      const orders = await this.#orchestrator.completeCheckoutAndCreateOrders(
+        {
+          shoppingCartId,
+          crmCustomer: customer,
+          crmShippingAddress: this.shippingAddress() ?? undefined,
+          crmPayer: this.payer() ?? undefined,
+          notificationChannels: customer.notificationChannels ?? 0,
+        },
+        this.#tabId() ?? undefined,
+      );
+
+      await this.#router.navigate([
+        `/${this.#tabId()}`,
+        'reward',
+        'order-confirmation',
+        orders.map((o) => o.id).join('+'),
+      ]);
+
+      this.isCompleted.set(true);
+      this.#logger.info('Order completed successfully', () => ({ orders }));
+    } catch (error) {
+      this.#logger.error('Error completing order', error);
+    } finally {
+      this.isBusy.set(false);
     }
-
-    const customer = this.#customerResource.resource.value();
-    if (!customer) {
-      throw new Error('No customer data available to complete order.');
-    }
-
-    // Get CRM shipping address and convert to checkout format
-    const crmShippingAddress = this.shippingAddress();
-    const shippingAddress = crmShippingAddress
-      ? ShippingAddressAdapter.fromCrmShippingAddress(crmShippingAddress)
-      : undefined;
-
-    // Get CRM payer and convert to checkout format
-    const crmPayer = this.payer();
-    const payer = crmPayer
-      ? PayerAdapter.toCheckoutFormat(crmPayer)
-      : undefined;
-
-    // Build buyer from customer
-    const buyer = CustomerAdapter.toBuyer(customer);
-
-    // Extract customer features
-    const customerFeatures = this.extractCustomerFeatures(customer);
-
-    // Complete checkout with all required parameters
-    this.#shoppingCartFacade.complete({
-      shoppingCartId,
-      buyer,
-      payer,
-      shippingAddress,
-      notificationChannels: customer.notificationChannels ?? 1,
-      customerFeatures,
-    });
-  }
-
-  /**
-   * Extract customer features as a record for checkout logic.
-   */
-  // TODO: Create CustomerFeaturesAdapter in crm-data-access
-  private extractCustomerFeatures(customer: any): Record<string, string> {
-    const features = customer.features || [];
-    return features.reduce((acc: Record<string, string>, feature: any) => {
-      acc[feature.key] = feature.key;
-      return acc;
-    }, {});
   }
 }
diff --git a/libs/checkout/feature/reward-shopping-cart/src/lib/services/checkout-completion-orchestrator.service.ts b/libs/checkout/feature/reward-shopping-cart/src/lib/services/checkout-completion-orchestrator.service.ts
new file mode 100644
index 000000000..843ae432d
--- /dev/null
+++ b/libs/checkout/feature/reward-shopping-cart/src/lib/services/checkout-completion-orchestrator.service.ts
@@ -0,0 +1,96 @@
+import { inject, Injectable } from '@angular/core';
+import {
+  ShoppingCartFacade,
+  CompleteCrmOrderParams,
+} from '@isa/checkout/data-access';
+import { OrderCreationFacade, OmsMetadataService } from '@isa/oms/data-access';
+import { logger } from '@isa/core/logging';
+import type { Order } from '@isa/checkout/data-access';
+
+/**
+ * Orchestrates checkout completion and order creation.
+ *
+ * @remarks
+ * This service coordinates cross-domain operations between checkout and OMS.
+ * It belongs in the feature layer to avoid data-access layer coupling.
+ *
+ * **Responsibilities:**
+ * - Coordinate CRM data transformation via ShoppingCartFacade
+ * - Orchestrate checkout completion
+ * - Trigger order creation
+ * - Provide unified error handling for the entire flow
+ *
+ * This orchestrator demonstrates proper architectural layering:
+ * - Feature layer orchestrates cross-domain workflows
+ * - Data-access facades remain focused on single-domain operations
+ * - Services don't depend on other domain facades
+ */
+@Injectable()
+export class CheckoutCompletionOrchestratorService {
+  #logger = logger(() => ({
+    service: 'CheckoutCompletionOrchestratorService',
+  }));
+
+  #shoppingCartFacade = inject(ShoppingCartFacade);
+  #orderCreationFacade = inject(OrderCreationFacade);
+  #omsMetadataService = inject(OmsMetadataService);
+
+  /**
+   * Complete checkout with CRM data and create orders.
+   *
+   * @param params - CRM-sourced checkout parameters
+   * @param abortSignal - Optional cancellation signal
+   * @returns Created orders
+   * @throws CheckoutCompletionError - If validation or order creation fails
+   *
+   * @example
+   * ```typescript
+   * const orders = await orchestrator.completeCheckoutAndCreateOrders({
+   *   shoppingCartId: 123,
+   *   crmCustomer: customer,
+   *   crmShippingAddress: address,
+   *   crmPayer: payer,
+   *   notificationChannels: 1,
+   * });
+   * ```
+   */
+  async completeCheckoutAndCreateOrders(
+    params: CompleteCrmOrderParams,
+    tabId?: number,
+    abortSignal?: AbortSignal,
+  ): Promise<Order[]> {
+    this.#logger.info('Starting checkout completion and order creation');
+
+    try {
+      // Step 1: Complete checkout with CRM data transformation
+      this.#logger.debug('Completing checkout with CRM data');
+      const checkoutId = await this.#shoppingCartFacade.completeWithCrmData(
+        params,
+        abortSignal,
+      );
+
+      const orders =
+        await this.#orderCreationFacade.createOrdersFromCheckout(checkoutId);
+
+      // Step 2: Update OMS metadata with created orders
+      if (tabId && orders.length > 0) {
+        this.#omsMetadataService.addDisplayOrders(tabId, orders);
+      }
+
+      this.#logger.info(
+        'Checkout completion and order creation successful',
+        () => ({
+          orderCount: orders.length,
+        }),
+      );
+
+      return orders;
+    } catch (error) {
+      this.#logger.error(
+        'Checkout completion and order creation failed',
+        error,
+      );
+      throw error;
+    }
+  }
+}
diff --git a/libs/checkout/feature/reward-shopping-cart/src/lib/services/index.ts b/libs/checkout/feature/reward-shopping-cart/src/lib/services/index.ts
new file mode 100644
index 000000000..e8840c962
--- /dev/null
+++ b/libs/checkout/feature/reward-shopping-cart/src/lib/services/index.ts
@@ -0,0 +1 @@
+export * from './checkout-completion-orchestrator.service';
diff --git a/libs/checkout/shared/product-info/README.md b/libs/checkout/shared/product-info/README.md
index f506f6a4b..cf37827e1 100644
--- a/libs/checkout/shared/product-info/README.md
+++ b/libs/checkout/shared/product-info/README.md
@@ -1,7 +1,1281 @@
-# checkout-shared-product-info
+# @isa/checkout/shared/product-info
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive collection of presentation components for displaying product information, destination details, and stock availability in checkout and rewards workflows.
 
-## Running unit tests
+## Overview
 
-Run `nx test checkout-shared-product-info` to execute the unit tests.
+The Product Info library provides three specialized components for rendering product-related information in the checkout domain. These components handle the visual presentation layer for reward redemptions, delivery/pickup destinations, and real-time stock availability. Each component is designed as a standalone Angular component with signal-based inputs and optimized change detection.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Components](#components)
+  - [ProductInfoRedemptionComponent](#productinforedemptioncomponent)
+  - [DestinationInfoComponent](#destinationinfocomponent)
+  - [StockInfoComponent](#stockinfocomponent)
+- [Type Definitions](#type-definitions)
+- [Usage Examples](#usage-examples)
+- [Styling and Customization](#styling-and-customization)
+- [Architecture Notes](#architecture-notes)
+- [Testing](#testing)
+- [Dependencies](#dependencies)
+
+## Features
+
+- **Product redemption display** - Formatted product information with reward points
+- **Destination visualization** - Dynamic display of shipping/pickup/in-store destinations
+- **Real-time stock info** - Asynchronous stock availability with loading states
+- **Flexible layouts** - Horizontal and vertical orientation support
+- **Signal-based reactivity** - Modern Angular signals for optimal performance
+- **Resource integration** - Angular Resource API for efficient data fetching
+- **E2E test support** - Comprehensive `data-what` attributes for automated testing
+- **Tailwind styling** - ISA design system integration with custom utilities
+- **OnPush change detection** - Optimized rendering performance
+- **Type-safe inputs** - Strict TypeScript types with discriminated unions
+
+## Quick Start
+
+### 1. Import Components
+
+```typescript
+import { Component } from '@angular/core';
+import {
+  ProductInfoRedemptionComponent,
+  DestinationInfoComponent,
+  StockInfoComponent,
+  type ProductInfoItem,
+  type StockInfoItem,
+} from '@isa/checkout/shared/product-info';
+
+@Component({
+  selector: 'app-checkout-summary',
+  template: '...',
+  imports: [
+    ProductInfoRedemptionComponent,
+    DestinationInfoComponent,
+    StockInfoComponent,
+  ],
+})
+export class CheckoutSummaryComponent {
+  // Component logic...
+}
+```
+
+### 2. Basic Product Info Display
+
+```typescript
+@Component({
+  template: `
+    <checkout-product-info-redemption
+      [item]="productItem()"
+      [orientation]="'vertical'"
+    />
+  `,
+  imports: [ProductInfoRedemptionComponent],
+})
+export class RewardItemComponent {
+  productItem = signal<ProductInfoItem>({
+    product: {
+      ean: '9783498007706',
+      name: 'Die Assistentin',
+      contributors: 'Wahl, Caroline',
+      format: 'TB',
+      formatDetail: 'Taschenbuch (Kartoniert)',
+      manufacturer: 'Rowohlt Verlag',
+      publicationDate: '2023-01-15',
+    },
+    redemptionPoints: 150,
+  });
+}
+```
+
+### 3. Destination Display
+
+```typescript
+@Component({
+  template: `
+    <checkout-destination-info
+      [shoppingCartItem]="cartItem()"
+      [underline]="true"
+    />
+  `,
+  imports: [DestinationInfoComponent],
+})
+export class CartItemComponent {
+  cartItem = signal({
+    availability: {
+      estimatedDelivery: {
+        start: '2024-06-10T00:00:00+02:00',
+        stop: '2024-06-12T00:00:00+02:00',
+      },
+    },
+    destination: {
+      data: {
+        target: ShippingTarget.Delivery,
+      },
+    },
+    features: {
+      orderType: 'Versand',
+    },
+  });
+}
+```
+
+### 4. Stock Information Display
+
+```typescript
+@Component({
+  template: `
+    <checkout-stock-info [item]="stockItem()" />
+  `,
+  imports: [StockInfoComponent],
+})
+export class ProductStockComponent {
+  stockItem = signal<StockInfoItem>({
+    id: 123456,
+    catalogAvailability: {
+      ssc: '999',
+      sscText: 'Lieferbar in 1-3 Werktagen',
+    },
+  });
+}
+```
+
+## Components
+
+### ProductInfoRedemptionComponent
+
+A presentation component for displaying product information with redemption points in reward workflows.
+
+#### Selector
+
+```html
+<checkout-product-info-redemption />
+```
+
+#### Inputs
+
+| Name | Type | Default | Required | Description |
+|------|------|---------|----------|-------------|
+| `item` | `ProductInfoItem` | - | ✓ | Product data with redemption points or loyalty information |
+| `orientation` | `'horizontal' \| 'vertical'` | `'vertical'` | ✗ | Layout orientation |
+
+#### Outputs
+
+None - presentation component only.
+
+#### Computed Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `points` | `Signal<number>` | Calculated reward points from redemptionPoints or loyalty.value |
+
+#### Host Bindings
+
+- **`class`**: Dynamically bound to `orientation()` for CSS styling
+
+#### Template Features
+
+- **Product Image**: Clickable product image with `sharedProductRouterLink` directive
+- **Contributors**: Bold product author/artist display
+- **Product Name**: Responsive typography (body-2 horizontal, subtitle-1 vertical)
+- **Reward Points**: Combined display of points value and "Lesepunkte" label
+- **Format Information**: Delegated to `shared-product-format` component
+- **Metadata**: Manufacturer, EAN, and publication date
+- **E2E Attributes**: `data-what="product-image"` for automated testing
+
+#### Example
+
+```typescript
+@Component({
+  template: `
+    <checkout-product-info-redemption
+      [item]="rewardItem()"
+      [orientation]="'horizontal'"
+    />
+  `,
+})
+export class RewardCardComponent {
+  rewardItem = signal<ProductInfoItem>({
+    product: {
+      ean: '9783498007706',
+      name: 'Die Assistentin',
+      contributors: 'Wahl, Caroline',
+      format: 'TB',
+      formatDetail: 'Taschenbuch (Kartoniert)',
+      manufacturer: 'Rowohlt Verlag',
+      publicationDate: '2023-01-15',
+    },
+    redemptionPoints: 150,
+  });
+}
+```
+
+### DestinationInfoComponent
+
+Displays shipping destination, branch information, or estimated delivery dates based on order type.
+
+#### Selector
+
+```html
+<checkout-destination-info />
+```
+
+#### Inputs
+
+| Name | Type | Default | Required | Description |
+|------|------|---------|----------|-------------|
+| `shoppingCartItem` | `Pick<ShoppingCartItem, 'availability' \| 'destination' \| 'features'>` | - | ✓ | Shopping cart item with destination data |
+| `underline` | `boolean` | `false` | ✗ | Add underline styling to destination header |
+
+#### Outputs
+
+None - presentation component only.
+
+#### Computed Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `orderType` | `Signal<OrderType>` | Extracted order type from cart item features |
+| `destinationIcon` | `Signal<string>` | Icon name based on order type (delivery, pickup, in-store) |
+| `displayAddress` | `Signal<boolean>` | Whether to show address (true for InStore, Pickup, B2B) |
+| `branchContainer` | `Signal<EntityReferenceContainer \| undefined>` | Branch reference from destination data |
+| `branch` | `LinkedSignal<Branch \| undefined>` | Resolved branch data from resource or container |
+| `name` | `Signal<string>` | Recipient name (customer or branch name) |
+| `address` | `Signal<Address \| undefined>` | Destination address (shipping or branch) |
+| `estimatedDelivery` | `Signal<{ start: string; stop: string \| null } \| null>` | Calculated delivery date range |
+
+#### Effects
+
+- **`branchChange`**: Automatically updates `BranchResource` params when branch container changes
+
+#### Injected Resources
+
+- **`BranchResource`**: Fetches branch details by ID
+- **`SelectedCustomerShippingAddressResource`**: Fetches customer shipping address
+
+#### Order Type Behavior
+
+| Order Type | Icon | Display Mode | Data Source |
+|------------|------|--------------|-------------|
+| **Versand** (Delivery) | `isaDeliveryVersand` | Estimated delivery dates | Availability data |
+| **Abholung** (Pickup) | `isaDeliveryRuecklage2` | Branch name + address | Destination.targetBranch |
+| **Rücklage** (InStore) | `isaDeliveryRuecklage1` | Branch name + address | Destination.targetBranch |
+| **B2B-Versand** | `isaDeliveryVersand` | Customer name + shipping address | ShippingAddressResource |
+| **DIG-Versand** | `isaDeliveryVersand` | Customer name + shipping address | ShippingAddressResource |
+
+#### Example
+
+```typescript
+@Component({
+  template: `
+    <checkout-destination-info
+      [shoppingCartItem]="cartItem()"
+      [underline]="true"
+    />
+  `,
+})
+export class ShippingInfoComponent {
+  cartItem = signal({
+    availability: {
+      estimatedDelivery: {
+        start: '2024-06-10T00:00:00+02:00',
+        stop: '2024-06-12T00:00:00+02:00',
+      },
+    },
+    destination: {
+      data: {
+        target: ShippingTarget.Branch,
+        targetBranch: {
+          id: 42,
+          data: {
+            name: 'Hauptfiliale München',
+            address: {
+              street: 'Marienplatz',
+              streetNumber: '1',
+              zipCode: '80331',
+              city: 'München',
+            },
+          },
+        },
+      },
+    },
+    features: {
+      orderType: 'Abholung',
+    },
+  });
+}
+```
+
+### StockInfoComponent
+
+Displays real-time stock availability with asynchronous loading states.
+
+#### Selector
+
+```html
+<checkout-stock-info />
+```
+
+#### Inputs
+
+| Name | Type | Default | Required | Description |
+|------|------|---------|----------|-------------|
+| `item` | `StockInfoItem` | - | ✓ | Item with catalog availability information |
+
+#### Outputs
+
+None - presentation component only.
+
+#### Computed Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `itemId` | `Signal<number>` | Extracted item ID from input |
+| `inStock` | `Signal<number>` | Current stock quantity (0 if not loaded) |
+| `loading` | `Signal<boolean>` | Loading state from resource |
+
+#### Public Properties
+
+| Name | Type | Description |
+|------|------|-------------|
+| `stockInfoResource` | `ResourceRef<StockInfo>` | Exposed resource reference for external access |
+
+#### Exported As
+
+```html
+<checkout-stock-info #stockInfo="stockInfo" />
+```
+
+Access resource methods:
+```typescript
+@ViewChild('stockInfo', { read: StockInfoComponent })
+stockInfoRef!: StockInfoComponent;
+
+reloadStock() {
+  this.stockInfoRef.stockInfoResource.reload();
+}
+```
+
+#### Resource Integration
+
+Uses `StockInfoResource` from `@isa/remission/data-access` with automatic parameter updates:
+
+```typescript
+readonly stockInfoResource = this.#stockInfoResource.resource(
+  computed(() => ({ itemId: this.itemId() }))
+);
+```
+
+#### Loading State Handling
+
+The component renders a skeleton loader during data fetching:
+
+```html
+@if (loading()) {
+  <ui-skeleton-loader class="w-8 h-5 inline-block"></ui-skeleton-loader>
+} @else {
+  {{ inStock() }}x
+}
+```
+
+#### Example
+
+```typescript
+@Component({
+  template: `
+    <checkout-stock-info
+      #stockInfo="stockInfo"
+      [item]="productItem()"
+    />
+    <button (click)="stockInfo.stockInfoResource.reload()">
+      Refresh Stock
+    </button>
+  `,
+})
+export class ProductAvailabilityComponent {
+  productItem = signal<StockInfoItem>({
+    id: 123456,
+    catalogAvailability: {
+      ssc: '10',
+      sscText: 'Sofort lieferbar',
+    },
+  });
+}
+```
+
+## Type Definitions
+
+### ProductInfoItem
+
+Discriminated union type supporting two product sources:
+
+```typescript
+type ProductInfoItem =
+  | {
+      product: Pick<
+        CatProduct,
+        'ean' | 'name' | 'contributors' | 'format' |
+        'formatDetail' | 'manufacturer' | 'publicationDate'
+      >;
+      redemptionPoints?: number;
+    }
+  | {
+      product: Pick<
+        CheckoutProduct,
+        'ean' | 'name' | 'contributors' | 'format' |
+        'formatDetail' | 'manufacturer' | 'publicationDate'
+      >;
+      loyalty: Pick<Loyalty, 'value'>;
+    };
+```
+
+**Catalog Product Variant:**
+- Uses `@isa/catalogue/data-access` Product type
+- Optional `redemptionPoints` field
+- Typical use: Reward catalog browsing
+
+**Checkout Product Variant:**
+- Uses `@isa/checkout/data-access` Product type
+- Required `loyalty` object with `value` field
+- Typical use: Shopping cart redemption items
+
+**Type Discrimination:**
+```typescript
+const item: ProductInfoItem = {...};
+
+if ('redemptionPoints' in item) {
+  // Catalog product variant
+  const points = item.redemptionPoints ?? 0;
+}
+
+if ('loyalty' in item) {
+  // Checkout product variant
+  const points = item.loyalty.value ?? 0;
+}
+```
+
+### StockInfoItem
+
+Simple type for stock availability display:
+
+```typescript
+type StockInfoItem = {
+  id: Item['id'];  // Product item ID
+  catalogAvailability: Pick<Item['catalogAvailability'], 'ssc' | 'sscText'>;
+};
+```
+
+**Fields:**
+- `id`: Numeric item identifier for stock lookup
+- `catalogAvailability.ssc`: Stock status code (e.g., "10", "999")
+- `catalogAvailability.sscText`: Human-readable status description
+
+## Usage Examples
+
+### Horizontal Product Info Layout
+
+```typescript
+@Component({
+  template: `
+    <checkout-product-info-redemption
+      [item]="product()"
+      [orientation]="'horizontal'"
+      class="border-b pb-4"
+    />
+  `,
+  imports: [ProductInfoRedemptionComponent],
+})
+export class HorizontalRewardComponent {
+  product = signal<ProductInfoItem>({
+    product: {
+      ean: '9783442488391',
+      name: 'Das Labyrinth des Fauns',
+      contributors: 'del Toro, Guillermo; Funke, Cornelia',
+      format: 'HC',
+      formatDetail: 'Hardcover (gebunden)',
+      manufacturer: 'Goldmann Verlag',
+      publicationDate: '2019-07-01',
+    },
+    redemptionPoints: 200,
+  });
+}
+```
+
+### Multiple Destination Types
+
+```typescript
+@Component({
+  template: `
+    @for (item of cartItems(); track item.id) {
+      <checkout-destination-info
+        [shoppingCartItem]="item"
+        [underline]="true"
+        class="mb-4"
+      />
+    }
+  `,
+  imports: [DestinationInfoComponent],
+})
+export class MultiDestinationComponent {
+  cartItems = signal([
+    {
+      id: 1,
+      availability: {
+        estimatedDelivery: {
+          start: '2024-06-15T00:00:00+02:00',
+          stop: null,
+        },
+      },
+      destination: { data: { target: ShippingTarget.Delivery } },
+      features: { orderType: 'Versand' },
+    },
+    {
+      id: 2,
+      destination: {
+        data: {
+          target: ShippingTarget.Branch,
+          targetBranch: {
+            id: 42,
+            data: {
+              name: 'Filiale Hamburg',
+              address: {
+                street: 'Mönckebergstraße',
+                streetNumber: '10',
+                zipCode: '20095',
+                city: 'Hamburg',
+              },
+            },
+          },
+        },
+      },
+      features: { orderType: 'Abholung' },
+    },
+  ]);
+}
+```
+
+### Stock Info with Manual Reload
+
+```typescript
+@Component({
+  template: `
+    <checkout-stock-info
+      #stockRef="stockInfo"
+      [item]="productItem()"
+    />
+
+    <button
+      (click)="refreshStock()"
+      [disabled]="stockRef.loading()"
+      class="mt-2 px-4 py-2 bg-blue-500 text-white rounded"
+    >
+      {{ stockRef.loading() ? 'Loading...' : 'Refresh Stock' }}
+    </button>
+  `,
+  imports: [StockInfoComponent],
+})
+export class StockRefreshComponent {
+  @ViewChild('stockRef', { read: StockInfoComponent })
+  stockInfoRef!: StockInfoComponent;
+
+  productItem = signal<StockInfoItem>({
+    id: 789012,
+    catalogAvailability: {
+      ssc: '20',
+      sscText: 'Lieferbar in 5-7 Werktagen',
+    },
+  });
+
+  refreshStock() {
+    this.stockInfoRef.stockInfoResource.reload();
+  }
+}
+```
+
+### Combined Product Display
+
+```typescript
+@Component({
+  template: `
+    <div class="grid grid-cols-[2fr,1fr] gap-6 p-4 border rounded">
+      <!-- Left: Product Info -->
+      <checkout-product-info-redemption
+        [item]="productData()"
+        [orientation]="'vertical'"
+      />
+
+      <!-- Right: Stock & Destination -->
+      <div class="flex flex-col gap-4">
+        <checkout-stock-info [item]="stockData()" />
+        <checkout-destination-info
+          [shoppingCartItem]="cartData()"
+          [underline]="false"
+        />
+      </div>
+    </div>
+  `,
+  imports: [
+    ProductInfoRedemptionComponent,
+    StockInfoComponent,
+    DestinationInfoComponent,
+  ],
+})
+export class ProductCardComponent {
+  productData = signal<ProductInfoItem>({
+    product: {
+      ean: '9783453441378',
+      name: 'Der Schwarm',
+      contributors: 'Schätzing, Frank',
+      format: 'TB',
+      formatDetail: 'Taschenbuch (Kartoniert)',
+      manufacturer: 'Heyne Verlag',
+      publicationDate: '2005-08-01',
+    },
+    redemptionPoints: 300,
+  });
+
+  stockData = signal<StockInfoItem>({
+    id: 456789,
+    catalogAvailability: {
+      ssc: '10',
+      sscText: 'Sofort lieferbar',
+    },
+  });
+
+  cartData = signal({
+    availability: {
+      estimatedShippingDate: '2024-06-08T00:00:00+02:00',
+    },
+    destination: { data: { target: ShippingTarget.Delivery } },
+    features: { orderType: 'Versand' },
+  });
+}
+```
+
+### Loyalty-Based Redemption
+
+```typescript
+@Component({
+  template: `
+    <checkout-product-info-redemption
+      [item]="loyaltyProduct()"
+      [orientation]="'horizontal'"
+    />
+  `,
+  imports: [ProductInfoRedemptionComponent],
+})
+export class LoyaltyRedemptionComponent {
+  loyaltyProduct = signal<ProductInfoItem>({
+    product: {
+      ean: '9783423140942',
+      name: 'Der Vorleser',
+      contributors: 'Schlink, Bernhard',
+      format: 'TB',
+      formatDetail: 'Taschenbuch (Kartoniert)',
+      manufacturer: 'dtv Verlag',
+      publicationDate: '1997-09-01',
+    },
+    loyalty: {
+      value: 250,  // Loyalty points instead of redemptionPoints
+    },
+  });
+}
+```
+
+### Conditional Rendering Based on Order Type
+
+```typescript
+@Component({
+  template: `
+    <checkout-destination-info
+      [shoppingCartItem]="cartItem()"
+      [underline]="shouldUnderline()"
+    />
+
+    @if (isDelivery()) {
+      <p class="mt-2 text-sm text-neutral-600">
+        Standard shipping applies (3-5 business days)
+      </p>
+    }
+
+    @if (isPickup() || isInStore()) {
+      <p class="mt-2 text-sm text-neutral-600">
+        Please bring a valid ID when picking up
+      </p>
+    }
+  `,
+  imports: [DestinationInfoComponent],
+})
+export class ConditionalDestinationComponent {
+  cartItem = signal({
+    availability: {
+      estimatedDelivery: {
+        start: '2024-06-20T00:00:00+02:00',
+        stop: '2024-06-22T00:00:00+02:00',
+      },
+    },
+    destination: { data: { target: ShippingTarget.Delivery } },
+    features: { orderType: 'Versand' },
+  });
+
+  orderType = computed(() =>
+    getOrderTypeFeature(this.cartItem().features)
+  );
+
+  isDelivery = computed(() => this.orderType() === OrderType.Delivery);
+  isPickup = computed(() => this.orderType() === OrderType.Pickup);
+  isInStore = computed(() => this.orderType() === OrderType.InStore);
+
+  shouldUnderline = computed(() => !this.isDelivery());
+}
+```
+
+## Styling and Customization
+
+### Tailwind CSS Integration
+
+All components use ISA design system utilities with Tailwind CSS:
+
+#### Typography Classes
+- `isa-text-body-2-bold`: Bold body text (14px)
+- `isa-text-body-2-regular`: Regular body text (14px)
+- `isa-text-subtitle-1-regular`: Larger subtitle text (16px)
+
+#### Color Classes
+- `text-neutral-900`: Primary text color
+- `text-neutral-600`: Secondary text color
+- `text-isa-secondary-900`: Secondary accent color
+
+#### Layout Classes
+- `grid`, `flex`: Flexbox and grid layouts
+- `gap-2`, `gap-4`, `gap-6`: Spacing utilities
+- `items-center`, `items-start`: Alignment utilities
+
+### Component-Specific Styles
+
+#### ProductInfoRedemptionComponent
+
+**Host Styles:**
+```css
+:host {
+  @apply grid gap-6 text-neutral-900;
+}
+
+:host.horizontal {
+  @apply grid-cols-[1fr,minmax(0,25rem)];
+}
+
+:host.vertical {
+  @apply grid-flow-row;
+}
+```
+
+**Custom Classes:**
+```css
+.checkout-product-info-redemption__image {
+  @apply w-14;  /* 56px fixed width */
+}
+
+shared-product-format span {
+  @apply isa-text-body-2-bold text-isa-secondary-900;
+}
+```
+
+**Layout Variations:**
+- **Horizontal**: Two-column grid with 1fr left, max-width 25rem right
+- **Vertical**: Single-column flow with left margin on metadata (ml-20)
+
+#### DestinationInfoComponent
+
+**Host Styles:**
+```css
+:host {
+  @apply flex flex-col items-start gap-2 flex-grow;
+}
+```
+
+**Custom Classes:**
+```css
+.address-container {
+  @apply line-clamp-2 break-words text-ellipsis;
+}
+
+.underline {
+  /* Applied dynamically via [class.underline] binding */
+}
+```
+
+**Icon Sizing:**
+- All icons: `1.5rem` (24px)
+- Color: `text-neutral-900`
+
+#### StockInfoComponent
+
+**Host Styles:**
+```css
+:host {
+  @apply grid grid-flow-row gap-2;
+}
+```
+
+**Grid Layout:**
+```css
+.grid.grid-cols-\[auto\,1fr\] {
+  /* Icon column: auto-sized */
+  /* Content column: fills remaining space */
+}
+```
+
+### Customization Examples
+
+#### Custom Product Image Size
+
+```typescript
+@Component({
+  template: `
+    <checkout-product-info-redemption
+      [item]="product()"
+      class="custom-image-size"
+    />
+  `,
+  styles: [`
+    ::ng-deep .custom-image-size .checkout-product-info-redemption__image {
+      @apply w-20 h-28;  /* Custom dimensions */
+    }
+  `],
+})
+export class CustomImageComponent { }
+```
+
+#### Custom Destination Styling
+
+```typescript
+@Component({
+  template: `
+    <checkout-destination-info
+      [shoppingCartItem]="item()"
+      class="custom-destination"
+    />
+  `,
+  styles: [`
+    .custom-destination {
+      @apply bg-neutral-100 p-4 rounded-lg;
+    }
+
+    .custom-destination .address-container {
+      @apply line-clamp-3;  /* Show 3 lines instead of 2 */
+    }
+  `],
+})
+export class CustomDestinationComponent { }
+```
+
+#### Custom Stock Info Colors
+
+```typescript
+@Component({
+  template: `
+    <checkout-stock-info
+      [item]="stockItem()"
+      class="stock-highlight"
+    />
+  `,
+  styles: [`
+    .stock-highlight {
+      @apply border-l-4 border-green-500 pl-4;
+    }
+
+    ::ng-deep .stock-highlight .isa-text-body-2-bold {
+      @apply text-green-700;
+    }
+  `],
+})
+export class CustomStockComponent { }
+```
+
+## Architecture Notes
+
+### Design Patterns
+
+#### 1. Presentation Components
+All three components follow the **Presentation Component** pattern:
+- No business logic or state management
+- Pure transformation of input data to visual output
+- Signal-based inputs for optimal change detection
+- OnPush change detection for performance
+
+#### 2. Resource Integration
+`DestinationInfoComponent` and `StockInfoComponent` demonstrate the **Resource Provider** pattern:
+- Self-contained resource management
+- Automatic parameter updates via computed signals
+- Loading state handling
+- Error boundary support
+
+#### 3. Type Safety
+Components use **Discriminated Unions** for flexible input types:
+- `ProductInfoItem` supports both catalog and checkout products
+- Type narrowing via `'redemptionPoints' in item` checks
+- Prevents runtime type errors
+
+### Component Responsibilities
+
+#### ProductInfoRedemptionComponent
+**Responsibility**: Display product metadata and reward points
+**Dependencies**: Product image/router directives, product format component
+**State**: Stateless (pure transformation)
+**Integration Points**: Product detail routing, image service
+
+#### DestinationInfoComponent
+**Responsibility**: Display destination with order-type-specific formatting
+**Dependencies**: Branch and shipping address resources
+**State**: Resource-managed (branch, shipping address)
+**Integration Points**: CRM shipping addresses, branch management
+
+#### StockInfoComponent
+**Responsibility**: Display real-time stock availability
+**Dependencies**: Stock info resource, skeleton loader
+**State**: Resource-managed (stock data)
+**Integration Points**: Inventory API, remission stock service
+
+### Known Architectural Considerations
+
+#### 1. Resource Provider Scope (Low Priority)
+
+**Current State:**
+- `DestinationInfoComponent` and `StockInfoComponent` provide resources at component level
+- Each component instance creates its own resource instances
+
+**Impact:**
+- Multiple instances fetch data independently
+- No resource sharing between sibling components
+
+**Consideration:**
+- For list views with many instances, consider parent-level resource provision
+- Example: Product list with stock info for each item
+
+**Optimization Strategy:**
+```typescript
+@Component({
+  template: `
+    @for (item of items(); track item.id) {
+      <checkout-stock-info [item]="item" />
+    }
+  `,
+  providers: [StockInfoResource],  // Shared resource for all children
+})
+export class ProductListComponent { }
+```
+
+#### 2. Destination Info Complexity (Medium Priority)
+
+**Current State:**
+- Component handles 5 different order types
+- Complex conditional logic for address vs. delivery date display
+- Multiple resource dependencies (branch, shipping address)
+
+**Consideration:**
+- Consider decomposition into smaller components:
+  - `DestinationDeliveryComponent` (Versand, DIG-Versand, B2B-Versand)
+  - `DestinationBranchComponent` (Abholung, Rücklage)
+- Benefits: Simpler logic, fewer dependencies per component
+
+**Current Justification:**
+- Single component ensures consistent icon/header rendering
+- Shared logic reduces code duplication
+- Complexity is well-encapsulated
+
+#### 3. Product Info Type Union (Low Priority)
+
+**Current State:**
+- Discriminated union supports both catalog and checkout products
+- Runtime type checking required (`'redemptionPoints' in item`)
+
+**Alternative:**
+- Two separate components: `ProductInfoCatalog`, `ProductInfoCheckout`
+- Eliminates runtime type checks
+- More explicit component selection
+
+**Current Justification:**
+- Single component provides consistent rendering
+- Type discrimination is lightweight
+- Simplifies template usage
+
+### Performance Considerations
+
+#### Change Detection Optimization
+All components use `OnPush` change detection:
+- Updates only when signal inputs change
+- No unnecessary re-renders
+- Optimal for large lists
+
+#### Resource Request Deduplication
+Resource APIs automatically deduplicate concurrent requests:
+```typescript
+// Multiple components requesting same stock data
+<checkout-stock-info [item]="{ id: 123, ... }" />
+<checkout-stock-info [item]="{ id: 123, ... }" />
+// Only one API request is made
+```
+
+#### Skeleton Loading States
+`StockInfoComponent` shows skeleton loaders during data fetching:
+- Prevents layout shift
+- Better perceived performance
+- User feedback during async operations
+
+### Future Enhancements
+
+1. **Virtualization Support**: Optimize for large product lists with virtual scrolling
+2. **Caching Strategy**: Implement resource-level caching for frequently accessed data
+3. **Offline Support**: Handle network failures gracefully with cached data
+4. **Accessibility**: Add ARIA labels and screen reader support
+5. **Analytics Integration**: Track user interactions with product info components
+
+## Testing
+
+The library uses **Vitest** with **Angular Testing Utilities** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test checkout-shared-product-info --skip-nx-cache
+
+# Run tests with coverage
+npx nx test checkout-shared-product-info --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test checkout-shared-product-info --watch
+```
+
+### Test Structure
+
+The library includes unit tests covering:
+
+- **Component creation** - Validates successful component instantiation
+- **Input bindings** - Tests signal input reactivity
+- **Computed properties** - Validates derived signal calculations
+- **Resource integration** - Tests resource parameter updates
+- **Loading states** - Validates skeleton loader display
+- **E2E attributes** - Ensures `data-what` attributes are present
+
+### Example Test: StockInfoComponent
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach } from 'vitest';
+import { StockInfoComponent } from './stock-info.component';
+import { RemissionStockService } from '@isa/remission/data-access';
+
+describe('StockInfoComponent', () => {
+  let component: StockInfoComponent;
+  let fixture: ComponentFixture<StockInfoComponent>;
+  let mockStockService: any;
+
+  beforeEach(() => {
+    mockStockService = {
+      fetchStockInfos: () => Promise.resolve([]),
+    };
+
+    TestBed.configureTestingModule({
+      imports: [StockInfoComponent],
+      providers: [
+        { provide: RemissionStockService, useValue: mockStockService },
+      ],
+    });
+
+    fixture = TestBed.createComponent(StockInfoComponent);
+    component = fixture.componentInstance;
+    fixture.componentRef.setInput('item', {
+      id: 123,
+      catalogAvailability: { ssc: '10', sscText: 'Available' },
+    });
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+
+  it('should have item input', () => {
+    expect(component.item()).toEqual({
+      id: 123,
+      catalogAvailability: { ssc: '10', sscText: 'Available' },
+    });
+  });
+
+  it('should initialize with zero inStock when no data loaded', () => {
+    expect(component.inStock()).toBe(0);
+  });
+
+  it('should have stockInfoResource ResourceRef defined', () => {
+    expect(component.stockInfoResource).toBeDefined();
+    expect(component.stockInfoResource.value).toBeDefined();
+    expect(component.stockInfoResource.isLoading).toBeDefined();
+    expect(component.stockInfoResource.reload).toBeDefined();
+  });
+});
+```
+
+### Testing Best Practices
+
+#### 1. Signal Input Testing
+
+Always use `fixture.componentRef.setInput()` for signal inputs:
+
+```typescript
+// Correct - for signal inputs
+fixture.componentRef.setInput('item', mockItem);
+fixture.detectChanges();
+
+// Incorrect - for signal inputs (won't work)
+component.item = signal(mockItem);
+```
+
+#### 2. Resource Mocking
+
+Mock resource dependencies at the service level:
+
+```typescript
+const mockStockService = {
+  fetchStockInfos: vi.fn().mockResolvedValue([
+    { itemId: 123, inStock: 5 }
+  ]),
+};
+
+TestBed.configureTestingModule({
+  providers: [
+    { provide: RemissionStockService, useValue: mockStockService },
+  ],
+});
+```
+
+#### 3. Computed Signal Testing
+
+Test computed signals after input changes:
+
+```typescript
+it('should calculate points from redemptionPoints', () => {
+  fixture.componentRef.setInput('item', {
+    product: { /* ... */ },
+    redemptionPoints: 150,
+  });
+  fixture.detectChanges();
+
+  expect(component.points()).toBe(150);
+});
+
+it('should calculate points from loyalty', () => {
+  fixture.componentRef.setInput('item', {
+    product: { /* ... */ },
+    loyalty: { value: 200 },
+  });
+  fixture.detectChanges();
+
+  expect(component.points()).toBe(200);
+});
+```
+
+#### 4. E2E Attribute Verification
+
+Verify E2E attributes in template:
+
+```typescript
+it('should have data-what attribute on product image', () => {
+  fixture.detectChanges();
+  const image = fixture.nativeElement.querySelector('img');
+  expect(image.getAttribute('data-what')).toBe('product-image');
+});
+```
+
+### Storybook Integration
+
+Each component has comprehensive Storybook stories for visual testing:
+
+#### Product Info Stories
+
+```typescript
+// apps/isa-app/stories/checkout/shared/product-info/product-info-redemption.stories.ts
+export const Primary: Story = {
+  args: {
+    item: {
+      product: {
+        ean: '9783498007706',
+        name: 'Die Assistentin',
+        contributors: 'Wahl, Caroline',
+        // ...
+      },
+      redemptionPoints: 100,
+    },
+    orientation: 'vertical',
+  },
+};
+```
+
+#### Running Storybook
+
+```bash
+npm run storybook
+# Navigate to: checkout/shared/product-info/*
+```
+
+### CI/CD Testing
+
+The library is included in CI test runs:
+
+```bash
+# CI command (used in pipelines)
+npm run ci
+# Or: npx nx run-many -t test -c ci
+```
+
+## Dependencies
+
+### Required Libraries
+
+#### Angular Core
+- `@angular/core` - Angular framework
+- `@angular/common` - Common Angular directives (DatePipe)
+- `@angular/cdk/coercion` - Coercion utilities (boolean inputs)
+
+#### Domain Libraries
+- `@isa/catalogue/data-access` - Catalog product types
+- `@isa/checkout/data-access` - Checkout product types, order types, shopping cart
+- `@isa/crm/data-access` - Customer shipping address resource
+- `@isa/remission/data-access` - Stock service and branch resource
+
+#### Shared Components
+- `@isa/shared/product-image` - Product image directive
+- `@isa/shared/product-router-link` - Product routing directive
+- `@isa/shared/product-foramt` - Product format display component
+- `@isa/shared/address` - Inline address component
+
+#### UI Components
+- `@isa/ui/skeleton-loader` - Loading skeleton component
+- `@ng-icons/core` - Icon component
+- `@isa/icons` - ISA icon set (isaFiliale, isaDeliveryVersand, etc.)
+
+#### Generated API
+- `@generated/swagger/inventory-api` - Stock info DTO types
+
+### Development Dependencies
+
+- `vitest` - Testing framework
+- `@angular/platform-browser-dynamic` - Testing utilities
+- `@storybook/angular` - Storybook integration
+
+### Path Alias
+
+Import from: `@isa/checkout/shared/product-info`
+
+### Peer Dependencies
+
+These must be provided by the consuming application:
+- Angular 20.1.2+
+- RxJS 7.5+
+- Tailwind CSS with ISA design system configuration
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/common/data-access/README.md b/libs/common/data-access/README.md
index f99c0c8f5..0930a6c54 100644
--- a/libs/common/data-access/README.md
+++ b/libs/common/data-access/README.md
@@ -1,7 +1,1563 @@
-# common-data-access
+# @isa/common/data-access
 
-This library was generated with [Nx](https://nx.dev).
+A foundational data access library providing core utilities, error handling, RxJS operators, response models, and advanced batching infrastructure for Angular applications.
 
-## Running unit tests
+## Overview
 
-Run `nx test common-data-access` to execute the unit tests.
+The Common Data Access library is the backbone of data layer functionality across the ISA application. It provides standardized error handling with specialized error classes, custom RxJS operators for request cancellation and keyboard-based flow control, response type definitions for API communication, and a sophisticated batching resource system for optimizing multiple concurrent API requests. This library enforces consistency across all domain-specific data access layers and reduces code duplication by centralizing common patterns.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Error Handling](#error-handling)
+- [RxJS Operators](#rxjs-operators)
+- [Batching Resource System](#batching-resource-system)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Structured error hierarchy** - Type-safe error classes with error codes and optional data
+- **Response type definitions** - Standardized API response interfaces with error handling
+- **Custom RxJS operators** - Request cancellation, keyboard-based abort, error transformation
+- **Batching resource infrastructure** - Angular resource-based request batching with smart caching
+- **Zod integration helpers** - User-friendly German error messages for validation failures
+- **AbortSignal utilities** - Keyboard-triggered abort controllers for user-cancellable operations
+- **Pagination support** - List response types with skip/take/hits metadata
+- **Batch response handling** - Complex batch operation results with success/failure tracking
+- **Type-safe async results** - Discriminated unions for async operation states
+- **TypeScript strict mode** - Full type safety with minimal type assertions
+
+## Quick Start
+
+### 1. Using Error Classes
+
+```typescript
+import { ResponseArgsError, PropertyIsEmptyError } from '@isa/common/data-access';
+
+// Check API response for errors
+try {
+  const response = await api.fetchData();
+  if (response.error) {
+    throw new ResponseArgsError(response);
+  }
+} catch (error) {
+  if (error instanceof ResponseArgsError) {
+    console.error('API error:', error.message);
+    console.error('Invalid properties:', error.responseArgs.invalidProperties);
+  }
+}
+
+// Validate required properties
+if (!userId || userId.trim() === '') {
+  throw new PropertyIsEmptyError('userId');
+}
+```
+
+### 2. Using RxJS Operators
+
+```typescript
+import { takeUntilAborted, catchResponseArgsErrorPipe } from '@isa/common/data-access';
+
+// Cancel request with AbortSignal
+fetchData(signal: AbortSignal) {
+  return this.api.getData().pipe(
+    takeUntilAborted(signal),
+    catchResponseArgsErrorPipe()
+  );
+}
+
+// Cancel on Escape key
+import { takeUntilKeydownEscape } from '@isa/common/data-access';
+
+searchProducts(query: string) {
+  return this.api.search(query).pipe(
+    takeUntilKeydownEscape(),
+    catchResponseArgsErrorPipe()
+  );
+}
+```
+
+### 3. Using Batching Resource
+
+```typescript
+import { BatchingResource } from '@isa/common/data-access';
+
+// Create a custom batching resource
+export class StockInfoResource extends BatchingResource<
+  number,              // Item ID (params)
+  FetchStockParams,    // API request params
+  StockInfo            // Result type
+> {
+  #stockService = inject(StockService);
+
+  constructor() {
+    super(250); // Batch window: 250ms
+  }
+
+  protected async fetchFn(params: FetchStockParams, signal: AbortSignal) {
+    return this.#stockService.fetchStockInfos(params, signal);
+  }
+
+  protected buildParams(itemIds: number[]): FetchStockParams {
+    return { itemIds };
+  }
+
+  protected getKeyFromResult(stock: StockInfo): number | undefined {
+    return stock.itemId;
+  }
+
+  protected getCacheKey(itemId: number): string {
+    return String(itemId);
+  }
+
+  protected extractKeysFromParams(params: FetchStockParams): number[] {
+    return params.itemIds;
+  }
+}
+
+// Use in components
+const stockResource = inject(StockInfoResource);
+const stockInfo = stockResource.resource(itemId);
+const inStock = computed(() => stockInfo.value()?.inStock ?? 0);
+```
+
+### 4. Handling Zod Validation Errors
+
+```typescript
+import { extractZodErrorMessage } from '@isa/common/data-access';
+import { z } from 'zod';
+
+const userSchema = z.object({
+  name: z.string().min(3),
+  email: z.string().email(),
+  age: z.number().min(18)
+});
+
+try {
+  userSchema.parse(invalidData);
+} catch (error) {
+  if (error instanceof z.ZodError) {
+    const message = extractZodErrorMessage(error);
+    // Returns German user-friendly message:
+    // "Es sind 3 Validierungsfehler aufgetreten:
+    //  • name: Text muss mindestens 3 Zeichen lang sein
+    //  • email: Ungültige E-Mail-Adresse
+    //  • age: Wert muss mindestens 18 sein"
+    this.showError(message);
+  }
+}
+```
+
+## Core Concepts
+
+### Error Hierarchy
+
+The library provides a structured error hierarchy with type-safe error codes:
+
+```
+Error (JavaScript built-in)
+  ↓
+DataAccessError<TCode, TData>
+  ↓
+├─→ ResponseArgsError (API errors)
+├─→ PropertyIsEmptyError (validation)
+└─→ PropertyNullOrUndefinedError (validation)
+```
+
+**Key Features:**
+- Type-safe error codes using string literals
+- Optional typed data attached to errors
+- Consistent error message formatting
+- Proper prototype chain for `instanceof` checks
+
+### Response Type Definitions
+
+All API responses follow standardized interfaces:
+
+#### ResponseArgs<T>
+Standard single-item response:
+```typescript
+interface ResponseArgs<T> {
+  error: boolean;                           // Error flag
+  invalidProperties?: Record<string, string>; // Validation errors
+  message?: string;                         // Error/success message
+  result: T;                               // Actual data
+}
+```
+
+#### ListResponseArgs<T>
+Paginated list response:
+```typescript
+interface ListResponseArgs<T> extends ResponseArgs<T[]> {
+  skip: number;   // Pagination offset
+  take: number;   // Page size
+  hits: number;   // Total count
+}
+```
+
+#### BatchResponseArgs<T>
+Batch operation results:
+```typescript
+interface BatchResponseArgs<T> {
+  alreadyProcessed?: Array<ReturnValue<T>>;
+  ambiguous?: Array<T>;
+  completed: boolean;
+  duplicates?: Array<{ key: T; value: number }>;
+  error: boolean;
+  failed?: Array<ReturnValue<T>>;
+  invalidProperties?: Record<string, string>;
+  message?: string;
+  requestId?: number;
+  successful?: Array<{ key: T; value: T }>;
+  total: number;
+  unknown?: Array<ReturnValue<T>>;
+}
+```
+
+### RxJS Operator Pipeline
+
+Custom operators integrate seamlessly with standard RxJS operators:
+
+```typescript
+this.api.fetchData().pipe(
+  takeUntilAborted(abortSignal),        // Cancellation
+  map(response => response.result),      // Transformation
+  catchResponseArgsErrorPipe(),          // Error handling
+  tap(data => this.#logger.info(data))   // Side effects
+);
+```
+
+### Batching Resource Architecture
+
+The `BatchingResource` abstract class provides:
+
+1. **Request Batching** - Collects params from multiple components
+2. **Batch Window** - Waits for configurable time before executing
+3. **Smart Caching** - Caches results including empty responses
+4. **Reference Counting** - Tracks component usage for cleanup
+5. **Per-Item Status** - Independent loading/error states
+6. **Automatic Cleanup** - Removes cached data when no longer needed
+
+**Lifecycle:**
+```
+Component A requests item 123
+         ↓
+BatchingResource adds to pending queue
+         ↓
+Component B requests item 456 (within batch window)
+         ↓
+Batch window expires (e.g., 250ms)
+         ↓
+Single API call: fetchItems([123, 456])
+         ↓
+Results cached with individual status
+         ↓
+Component A destroys → ref count decreases
+         ↓
+Component B destroys → ref count = 0 → cache cleared
+```
+
+## API Reference
+
+### Error Classes
+
+#### `DataAccessError<TCode, TData>`
+
+Base error class for all data access errors with type-safe error codes.
+
+**Type Parameters:**
+- `TCode extends string` - String literal type for error code
+- `TData = void` - Type for additional error data (defaults to void)
+
+**Constructor:**
+```typescript
+constructor(
+  code: TCode,
+  message: string,
+  data: TData
+)
+```
+
+**Properties:**
+- `code: TCode` - Unique error code identifier
+- `message: string` - Human-readable error description
+- `data: TData` - Additional context-specific error data
+- `name: string` - Error class name (automatically set)
+
+**Example:**
+```typescript
+class CustomError extends DataAccessError<'CUSTOM_ERROR', { field: string }> {
+  constructor(field: string) {
+    super('CUSTOM_ERROR', `Validation failed for ${field}`, { field });
+  }
+}
+
+const error = new CustomError('email');
+console.log(error.code);  // 'CUSTOM_ERROR'
+console.log(error.data.field);  // 'email'
+```
+
+#### `ResponseArgsError<T>`
+
+Error thrown when API response indicates an error condition.
+
+**Constructor:**
+```typescript
+constructor(responseArgs: Omit<ResponseArgs<T>, 'result'>)
+```
+
+**Properties:**
+- `responseArgs: Omit<ResponseArgs<T>, 'result'>` - Original response without result
+- `code: 'RESPONSE_ARGS_ERROR'` - Fixed error code
+- `message: string` - Constructed from response message or invalid properties
+
+**Example:**
+```typescript
+const response = await api.fetchUser(userId);
+
+if (response.error) {
+  throw new ResponseArgsError(response);
+  // Message: "User not found" (from response.message)
+  // Or: "email: Invalid format; age: Must be positive"
+}
+```
+
+#### `PropertyIsEmptyError`
+
+Error for empty string properties that should have values.
+
+**Constructor:**
+```typescript
+constructor(propertyName: string)
+```
+
+**Properties:**
+- `code: 'PROPERTY_IS_EMPTY'` - Fixed error code
+- `message: string` - "Property \"{propertyName}\" is empty."
+
+**Example:**
+```typescript
+function validateUsername(username: string) {
+  if (!username || username.trim() === '') {
+    throw new PropertyIsEmptyError('username');
+  }
+}
+```
+
+#### `PropertyNullOrUndefinedError`
+
+Error for null or undefined properties that are required.
+
+**Constructor:**
+```typescript
+constructor(propertyName: string)
+```
+
+**Properties:**
+- `code: 'PROPERTY_NULL_OR_UNDEFINED'` - Fixed error code
+- `message: string` - "Property \"{propertyName}\" is null or undefined."
+
+**Example:**
+```typescript
+function processUser(user: User | null) {
+  if (user === null || user === undefined) {
+    throw new PropertyNullOrUndefinedError('user');
+  }
+  // Process user...
+}
+```
+
+### RxJS Operators
+
+#### `takeUntilAborted<T>(signal: AbortSignal)`
+
+Completes the observable when the provided AbortSignal is aborted.
+
+**Parameters:**
+- `signal: AbortSignal` - Signal that triggers completion when aborted
+
+**Returns:** `OperatorFunction<T, T>`
+
+**Example:**
+```typescript
+fetchData(signal: AbortSignal): Observable<Data> {
+  return this.httpClient.get<Data>(url).pipe(
+    takeUntilAborted(signal)
+  );
+}
+
+// Usage
+const controller = new AbortController();
+const data$ = this.service.fetchData(controller.signal);
+
+// Cancel after 5 seconds
+setTimeout(() => controller.abort(), 5000);
+```
+
+#### `takeUntilKeydown<T>(key: string)`
+
+Completes the observable when a specific keyboard key is pressed.
+
+**Parameters:**
+- `key: string` - Keyboard key name (e.g., 'Escape', 'Enter', 'Backspace')
+
+**Returns:** `OperatorFunction<T, T>`
+
+**Example:**
+```typescript
+// Cancel search on any key press
+search$ = this.searchControl.valueChanges.pipe(
+  debounceTime(300),
+  switchMap(query =>
+    this.api.search(query).pipe(
+      takeUntilKeydown('Escape')  // User can cancel with Escape
+    )
+  )
+);
+```
+
+#### `takeUntilKeydownEscape<T>()`
+
+Convenience operator that completes on Escape key press.
+
+**Returns:** `OperatorFunction<T, T>`
+
+**Example:**
+```typescript
+import { rxMethod } from '@ngrx/signals/rxjs-interop';
+import { takeUntilKeydownEscape } from '@isa/common/data-access';
+
+loadData = rxMethod<number>(
+  pipe(
+    switchMap(id =>
+      this.api.fetchData(id).pipe(
+        takeUntilKeydownEscape(),  // User-cancellable
+        tapResponse(
+          data => this.patchState({ data }),
+          error => this.#logger.error('Load failed', error)
+        )
+      )
+    )
+  )
+);
+```
+
+#### `catchResponseArgsErrorPipe<T>()`
+
+Catches HTTP errors and transforms them into ResponseArgsError instances.
+
+**Returns:** `OperatorFunction<T, T>`
+
+**Behavior:**
+- If error is already `ResponseArgsError`, re-throws as-is
+- If error is `HttpErrorResponse` with `ResponseArgs` payload, creates `ResponseArgsError`
+- Otherwise, re-throws original error
+
+**Example:**
+```typescript
+saveUser(user: User): Observable<User> {
+  return this.httpClient.post<ResponseArgs<User>>(url, user).pipe(
+    catchResponseArgsErrorPipe(),
+    map(response => response.result)
+  );
+}
+
+// Catch and handle
+this.service.saveUser(user).subscribe({
+  next: savedUser => console.log('Saved:', savedUser),
+  error: error => {
+    if (error instanceof ResponseArgsError) {
+      // Display API validation errors
+      this.showErrors(error.responseArgs.invalidProperties);
+    }
+  }
+});
+```
+
+### Helper Functions
+
+#### `extractZodErrorMessage(error: ZodError): string`
+
+Extracts and formats user-friendly German error messages from Zod validation errors.
+
+**Parameters:**
+- `error: ZodError` - Zod validation error instance
+
+**Returns:** Formatted German error message string
+
+**Features:**
+- German translations for all Zod error types
+- Field path formatting with → separators
+- Type translations (string → Text, number → Zahl)
+- Detailed messages for size constraints
+- Support for arrays, dates, emails, URLs, etc.
+
+**Example:**
+```typescript
+import { extractZodErrorMessage } from '@isa/common/data-access';
+import { z } from 'zod';
+
+const schema = z.object({
+  name: z.string().min(3).max(50),
+  email: z.string().email(),
+  age: z.number().min(18),
+  items: z.array(z.string()).min(1)
+});
+
+try {
+  schema.parse({
+    name: 'Jo',
+    email: 'invalid',
+    age: 15,
+    items: []
+  });
+} catch (error) {
+  if (error instanceof z.ZodError) {
+    console.log(extractZodErrorMessage(error));
+    // Output:
+    // Es sind 4 Validierungsfehler aufgetreten:
+    //
+    // • name: Text muss mindestens 3 Zeichen lang sein
+    // • email: Ungültige E-Mail-Adresse
+    // • age: Wert muss mindestens 18 sein
+    // • items: Liste muss mindestens 1 Elemente enthalten
+  }
+}
+```
+
+#### `createEscAbortControllerHelper(): AbortController`
+
+Creates an AbortController that aborts when the Escape key is pressed.
+
+**Returns:** AbortController that self-aborts on Escape key
+
+**Features:**
+- Automatically attaches keyboard listener to document
+- Cleans up listener when aborted
+- Useful for user-cancellable long-running operations
+
+**Example:**
+```typescript
+import { createEscAbortControllerHelper } from '@isa/common/data-access';
+
+async function searchWithEscapeCancel(query: string) {
+  const escController = createEscAbortControllerHelper();
+
+  try {
+    const results = await fetch(`/api/search?q=${query}`, {
+      signal: escController.signal
+    });
+    return await results.json();
+  } catch (error) {
+    if (error.name === 'AbortError') {
+      console.log('Search cancelled by user (Escape pressed)');
+    } else {
+      throw error;
+    }
+  }
+}
+```
+
+### Models and Types
+
+#### `AsyncResult<T>`
+
+Interface representing the state of an asynchronous operation.
+
+```typescript
+const AsyncResultStatus = {
+  Idle: 'Idle',
+  Pending: 'Pending',
+  Success: 'Success',
+  Error: 'Error',
+} as const;
+
+interface AsyncResult<T> {
+  status: AsyncResultStatus;
+  data?: T;
+  error?: unknown;
+}
+```
+
+**Example:**
+```typescript
+import { AsyncResult, AsyncResultStatus } from '@isa/common/data-access';
+
+class DataStore {
+  userData = signal<AsyncResult<User>>({
+    status: AsyncResultStatus.Idle
+  });
+
+  async loadUser(id: number) {
+    this.userData.set({ status: AsyncResultStatus.Pending });
+
+    try {
+      const user = await this.api.fetchUser(id);
+      this.userData.set({
+        status: AsyncResultStatus.Success,
+        data: user
+      });
+    } catch (error) {
+      this.userData.set({
+        status: AsyncResultStatus.Error,
+        error
+      });
+    }
+  }
+}
+```
+
+#### `CallbackResult<T>`
+
+Discriminated union for callback-based async results.
+
+```typescript
+type CallbackResult<T> =
+  | { data: T; error?: unknown }
+  | { data?: T; error: unknown };
+
+type Callback<T> = (result: CallbackResult<T>) => void;
+```
+
+**Example:**
+```typescript
+import { CallbackResult, Callback } from '@isa/common/data-access';
+
+function fetchData(callback: Callback<User>): void {
+  api.getUser()
+    .then(user => callback({ data: user }))
+    .catch(error => callback({ error }));
+}
+
+// Usage
+fetchData((result) => {
+  if (result.error) {
+    console.error('Failed:', result.error);
+  } else {
+    console.log('Success:', result.data);
+  }
+});
+```
+
+#### `ReturnValue<T>`
+
+Represents the result of an operation with optional error information.
+
+```typescript
+interface ReturnValue<T> {
+  error: boolean;
+  invalidProperties?: Record<string, string>;
+  message?: string;
+  result: T;
+}
+```
+
+**Used In:** `BatchResponseArgs` for tracking individual item results
+
+### Batching Resource
+
+#### `BatchingResource<TParams, TResourceParams, TResourceValue>`
+
+Abstract base class for implementing request batching with Angular resources.
+
+**Type Parameters:**
+- `TParams` - Individual item parameter type (e.g., `number` for item ID)
+- `TResourceParams` - Batch API request parameter type (e.g., `{ itemIds: number[] }`)
+- `TResourceValue` - Result type for individual items (e.g., `StockInfo`)
+
+**Constructor:**
+```typescript
+constructor(batchWindowMs = 100)
+```
+
+**Abstract Methods (Must Implement):**
+
+```typescript
+// Fetch data for multiple params
+protected abstract fetchFn(
+  params: TResourceParams,
+  abortSignal: AbortSignal
+): Promise<TResourceValue[]>;
+
+// Build API params from item params
+protected abstract buildParams(params: TParams[]): TResourceParams;
+
+// Extract params from result for cache matching
+protected abstract getKeyFromResult(result: TResourceValue): TParams | undefined;
+
+// Generate cache key from params
+protected abstract getCacheKey(params: TParams): string;
+
+// Extract original params from API params (for status tracking)
+protected abstract extractKeysFromParams(params: TResourceParams): TParams[];
+```
+
+**Public Methods:**
+
+##### `resource(params: Signal<TParams> | TParams): BatchingResourceRef<TResourceValue>`
+
+Creates a resource reference for specific params with automatic batching and cleanup.
+
+**Parameters:**
+- `params: Signal<TParams> | TParams` - Item params (can be signal or static value)
+
+**Returns:** `BatchingResourceRef<TResourceValue>` with properties:
+- `value: Signal<TResourceValue | undefined>` - Resource value
+- `hasValue: Signal<boolean>` - Whether value has been loaded
+- `isLoading: Signal<boolean>` - Loading state
+- `error: Signal<unknown>` - Error state
+- `status: Signal<ResourceStatus>` - Current status (idle/loading/resolved/error)
+- `reload: () => void` - Reload this specific item
+
+**Example:**
+```typescript
+// In component
+const itemId = signal(123);
+const stockInfo = stockResource.resource(itemId);
+
+// Template
+@if (stockInfo.isLoading()) {
+  <div>Loading stock info...</div>
+} @else if (stockInfo.error()) {
+  <div>Error: {{ stockInfo.error() }}</div>
+} @else if (stockInfo.hasValue()) {
+  <div>In Stock: {{ stockInfo.value()?.quantity }}</div>
+}
+```
+
+##### `reload(): void`
+
+Reloads all currently requested items by clearing cache.
+
+##### `reloadKeys(params: TParams[]): void`
+
+Reloads specific items by removing them from cache.
+
+**Example:**
+```typescript
+// Reload all items
+stockResource.reload();
+
+// Reload specific items
+stockResource.reloadKeys([123, 456]);
+```
+
+## Usage Examples
+
+### Error Handling Patterns
+
+#### API Response Validation
+
+```typescript
+import { ResponseArgsError } from '@isa/common/data-access';
+import { logger } from '@isa/core/logging';
+
+class UserService {
+  #logger = logger(() => ({ service: 'UserService' }));
+
+  async createUser(userData: CreateUserDto): Promise<User> {
+    const response = await this.api.createUser(userData);
+
+    if (response.error) {
+      this.#logger.error('User creation failed', {
+        message: response.message,
+        invalidProperties: response.invalidProperties
+      });
+      throw new ResponseArgsError(response);
+    }
+
+    return response.result;
+  }
+}
+
+// Component usage
+try {
+  const user = await this.#userService.createUser(formData);
+  this.showSuccess('User created successfully');
+} catch (error) {
+  if (error instanceof ResponseArgsError) {
+    // Display validation errors to user
+    const errors = error.responseArgs.invalidProperties;
+    Object.entries(errors ?? {}).forEach(([field, message]) => {
+      this.form.get(field)?.setErrors({ server: message });
+    });
+  }
+}
+```
+
+#### Property Validation
+
+```typescript
+import {
+  PropertyIsEmptyError,
+  PropertyNullOrUndefinedError
+} from '@isa/common/data-access';
+
+class OrderService {
+  validateOrder(order: Order | null): asserts order is Order {
+    if (order === null || order === undefined) {
+      throw new PropertyNullOrUndefinedError('order');
+    }
+
+    if (!order.customerId || order.customerId.trim() === '') {
+      throw new PropertyIsEmptyError('customerId');
+    }
+
+    if (order.items.length === 0) {
+      throw new PropertyIsEmptyError('items');
+    }
+  }
+
+  async processOrder(order: Order | null): Promise<void> {
+    this.validateOrder(order);
+    // TypeScript now knows order is non-null Order
+    await this.api.submitOrder(order);
+  }
+}
+```
+
+### RxJS Operator Combinations
+
+#### User-Cancellable Search
+
+```typescript
+import { Component, inject, signal } from '@angular/core';
+import { takeUntilKeydownEscape, catchResponseArgsErrorPipe } from '@isa/common/data-access';
+import { debounceTime, switchMap } from 'rxjs/operators';
+
+@Component({
+  selector: 'app-product-search',
+  template: `
+    <input
+      type="search"
+      [(ngModel)]="searchQuery"
+      placeholder="Search products (Escape to cancel)..." />
+
+    @if (searching()) {
+      <div>Searching... (Press Escape to cancel)</div>
+    }
+
+    @for (product of products(); track product.id) {
+      <div>{{ product.name }}</div>
+    }
+  `
+})
+export class ProductSearchComponent {
+  #searchService = inject(ProductSearchService);
+
+  searchQuery = signal('');
+  searching = signal(false);
+  products = signal<Product[]>([]);
+
+  constructor() {
+    // React to search query changes
+    effect(() => {
+      const query = this.searchQuery();
+      if (query.length < 3) return;
+
+      this.searching.set(true);
+
+      this.#searchService.search(query).pipe(
+        debounceTime(300),
+        takeUntilKeydownEscape(),  // User can press Escape to cancel
+        catchResponseArgsErrorPipe()
+      ).subscribe({
+        next: results => {
+          this.products.set(results);
+          this.searching.set(false);
+        },
+        error: () => {
+          this.searching.set(false);
+        }
+      });
+    });
+  }
+}
+```
+
+#### AbortSignal Integration
+
+```typescript
+import { Component, inject, DestroyRef } from '@angular/core';
+import { takeUntilAborted, catchResponseArgsErrorPipe } from '@isa/common/data-access';
+
+@Component({
+  selector: 'app-data-loader',
+  template: '...'
+})
+export class DataLoaderComponent {
+  #destroyRef = inject(DestroyRef);
+  #abortController = new AbortController();
+
+  constructor() {
+    // Abort on component destroy
+    this.#destroyRef.onDestroy(() => {
+      this.#abortController.abort();
+    });
+  }
+
+  loadData() {
+    return this.api.fetchData().pipe(
+      takeUntilAborted(this.#abortController.signal),
+      catchResponseArgsErrorPipe(),
+      tap(data => this.processData(data))
+    );
+  }
+
+  cancel() {
+    this.#abortController.abort();
+    this.#abortController = new AbortController(); // Create new for next request
+  }
+}
+```
+
+### Batching Resource Implementation
+
+#### Stock Information Batching
+
+```typescript
+import { Injectable } from '@angular/core';
+import { BatchingResource } from '@isa/common/data-access';
+
+interface FetchStockParams {
+  itemIds: number[];
+}
+
+interface StockInfo {
+  itemId: number;
+  inStock: number;
+  reserved: number;
+  available: number;
+}
+
+@Injectable({ providedIn: 'root' })
+export class StockInfoResource extends BatchingResource<
+  number,
+  FetchStockParams,
+  StockInfo
+> {
+  #stockService = inject(StockService);
+
+  constructor() {
+    super(250); // 250ms batch window
+  }
+
+  protected async fetchFn(
+    params: FetchStockParams,
+    signal: AbortSignal
+  ): Promise<StockInfo[]> {
+    return this.#stockService.fetchStockInfos(params, signal);
+  }
+
+  protected buildParams(itemIds: number[]): FetchStockParams {
+    return { itemIds };
+  }
+
+  protected getKeyFromResult(stock: StockInfo): number | undefined {
+    return stock.itemId;
+  }
+
+  protected getCacheKey(itemId: number): string {
+    return String(itemId);
+  }
+
+  protected extractKeysFromParams(params: FetchStockParams): number[] {
+    return params.itemIds;
+  }
+}
+
+// Usage in component
+@Component({
+  selector: 'app-product-card',
+  template: `
+    <div class="product">
+      <h3>{{ product().name }}</h3>
+
+      @if (stockInfo.isLoading()) {
+        <div>Loading stock...</div>
+      } @else if (stockInfo.error()) {
+        <div class="error">Stock unavailable</div>
+      } @else {
+        <div class="stock">
+          Available: {{ stockInfo.value()?.available ?? 0 }}
+        </div>
+      }
+    </div>
+  `
+})
+export class ProductCardComponent {
+  #stockResource = inject(StockInfoResource);
+
+  product = input.required<Product>();
+
+  // Automatically batches with other ProductCardComponents
+  stockInfo = this.#stockResource.resource(
+    computed(() => this.product().itemId)
+  );
+}
+```
+
+#### Complex Batching with Custom Cache Keys
+
+```typescript
+interface PriceParams {
+  itemId: number;
+  customerId: string;
+  quantity: number;
+}
+
+interface FetchPricesParams {
+  requests: Array<{
+    itemId: number;
+    customerId: string;
+    quantity: number;
+  }>;
+}
+
+interface PriceInfo {
+  itemId: number;
+  customerId: string;
+  quantity: number;
+  price: number;
+  discount: number;
+}
+
+@Injectable({ providedIn: 'root' })
+export class CustomerPriceResource extends BatchingResource<
+  PriceParams,
+  FetchPricesParams,
+  PriceInfo
+> {
+  #pricingService = inject(PricingService);
+
+  constructor() {
+    super(100);
+  }
+
+  protected async fetchFn(
+    params: FetchPricesParams,
+    signal: AbortSignal
+  ): Promise<PriceInfo[]> {
+    return this.#pricingService.fetchPrices(params, signal);
+  }
+
+  protected buildParams(requests: PriceParams[]): FetchPricesParams {
+    return { requests };
+  }
+
+  protected getKeyFromResult(price: PriceInfo): PriceParams | undefined {
+    return {
+      itemId: price.itemId,
+      customerId: price.customerId,
+      quantity: price.quantity
+    };
+  }
+
+  protected getCacheKey(params: PriceParams): string {
+    // Composite key for complex caching
+    return `${params.itemId}-${params.customerId}-${params.quantity}`;
+  }
+
+  protected extractKeysFromParams(params: FetchPricesParams): PriceParams[] {
+    return params.requests;
+  }
+}
+```
+
+### Zod Integration with Error Messages
+
+```typescript
+import { z } from 'zod';
+import { extractZodErrorMessage } from '@isa/common/data-access';
+
+// Define schema
+const orderSchema = z.object({
+  customerId: z.string().min(1, 'Customer required'),
+  items: z.array(
+    z.object({
+      productId: z.number().positive(),
+      quantity: z.number().int().positive(),
+      price: z.number().nonnegative()
+    })
+  ).min(1),
+  deliveryDate: z.date().min(new Date()),
+  email: z.string().email(),
+  phone: z.string().regex(/^\+?[0-9\s-]+$/),
+  notes: z.string().max(500).optional()
+});
+
+// Service with validation
+class OrderService {
+  async createOrder(data: unknown): Promise<Order> {
+    try {
+      const validatedOrder = orderSchema.parse(data);
+      return await this.api.createOrder(validatedOrder);
+    } catch (error) {
+      if (error instanceof z.ZodError) {
+        const message = extractZodErrorMessage(error);
+        throw new Error(message);  // German error message for users
+      }
+      throw error;
+    }
+  }
+}
+
+// Component usage
+try {
+  await this.#orderService.createOrder(formData);
+  this.showSuccess('Order created');
+} catch (error) {
+  if (error instanceof Error) {
+    // Display German validation errors
+    this.showError(error.message);
+  }
+}
+```
+
+## Error Handling
+
+### Error Type Hierarchy
+
+```typescript
+// Check error types with instanceof
+try {
+  await someOperation();
+} catch (error) {
+  if (error instanceof ResponseArgsError) {
+    // API returned error response
+    console.error('API Error:', error.responseArgs.message);
+
+  } else if (error instanceof PropertyIsEmptyError) {
+    // Required property was empty
+    console.error('Validation Error:', error.message);
+
+  } else if (error instanceof PropertyNullOrUndefinedError) {
+    // Required property was null/undefined
+    console.error('Null Check Error:', error.message);
+
+  } else if (error instanceof DataAccessError) {
+    // Generic data access error
+    console.error('Data Access Error:', error.code, error.message);
+
+  } else {
+    // Unknown error
+    console.error('Unexpected Error:', error);
+  }
+}
+```
+
+### Creating Custom Error Classes
+
+```typescript
+import { DataAccessError } from '@isa/common/data-access';
+
+// Error with no additional data
+class ResourceNotFoundError extends DataAccessError<'RESOURCE_NOT_FOUND'> {
+  constructor(resourceType: string, resourceId: string) {
+    super(
+      'RESOURCE_NOT_FOUND',
+      `${resourceType} with ID ${resourceId} not found`
+    );
+  }
+}
+
+// Error with typed data
+interface ValidationErrorData {
+  fields: Record<string, string[]>;
+  timestamp: Date;
+}
+
+class ValidationError extends DataAccessError<
+  'VALIDATION_ERROR',
+  ValidationErrorData
+> {
+  constructor(fields: Record<string, string[]>) {
+    const fieldCount = Object.keys(fields).length;
+    super(
+      'VALIDATION_ERROR',
+      `Validation failed for ${fieldCount} field(s)`,
+      { fields, timestamp: new Date() }
+    );
+  }
+}
+
+// Usage
+throw new ResourceNotFoundError('User', '12345');
+
+throw new ValidationError({
+  email: ['Invalid format', 'Already exists'],
+  password: ['Too short']
+});
+```
+
+### Error Handling Best Practices
+
+1. **Use Specific Error Types** - Choose the most specific error class
+2. **Preserve Error Context** - Include relevant data in error instances
+3. **Log Before Throwing** - Log detailed context, throw user-friendly errors
+4. **Type Guards** - Use `instanceof` for error type checking
+5. **Error Transformation** - Use `catchResponseArgsErrorPipe()` for HTTP errors
+
+## RxJS Operators
+
+### Operator Composition
+
+```typescript
+import {
+  takeUntilAborted,
+  takeUntilKeydownEscape,
+  catchResponseArgsErrorPipe
+} from '@isa/common/data-access';
+import { debounceTime, distinctUntilChanged, switchMap, retry } from 'rxjs/operators';
+
+// Complex operator pipeline
+searchProducts(query$: Observable<string>, signal: AbortSignal) {
+  return query$.pipe(
+    debounceTime(300),                    // Wait for typing to stop
+    distinctUntilChanged(),                // Only when query changes
+    switchMap(query =>                     // Switch to new search
+      this.api.search(query).pipe(
+        takeUntilAborted(signal),          // Cancel with AbortSignal
+        takeUntilKeydownEscape(),          // Cancel with Escape key
+        retry({ count: 2, delay: 1000 })   // Retry on failures
+      )
+    ),
+    catchResponseArgsErrorPipe(),          // Transform API errors
+    tap(results => this.#logger.info(`Found ${results.length} products`))
+  );
+}
+```
+
+### Custom Operator Creation
+
+```typescript
+import { pipe } from 'rxjs';
+import { takeUntilAborted, catchResponseArgsErrorPipe } from '@isa/common/data-access';
+
+// Reusable operator factory
+function withStandardErrorHandling<T>(signal: AbortSignal) {
+  return pipe(
+    takeUntilAborted(signal),
+    catchResponseArgsErrorPipe<T>(),
+    tap({
+      error: (error) => {
+        if (error instanceof ResponseArgsError) {
+          // Log API errors
+          console.error('API Error:', error.responseArgs);
+        }
+      }
+    })
+  );
+}
+
+// Usage
+this.api.getData().pipe(
+  withStandardErrorHandling(abortSignal),
+  map(data => processData(data))
+);
+```
+
+## Batching Resource System
+
+### Benefits of Batching
+
+**Without Batching:**
+```typescript
+// 100 components each make separate API calls
+Component 1: GET /api/stock?itemId=123
+Component 2: GET /api/stock?itemId=456
+Component 3: GET /api/stock?itemId=789
+// ... 97 more requests
+// Total: 100 HTTP requests
+```
+
+**With Batching:**
+```typescript
+// Single batched request after 250ms window
+POST /api/stock/batch
+Body: { itemIds: [123, 456, 789, ...] }
+// Total: 1 HTTP request
+```
+
+### Batching Window Tuning
+
+```typescript
+// Fast batching (50ms) - for critical path, low latency
+new MyResource(50);
+
+// Balanced batching (250ms) - default, good for most cases
+new MyResource(250);
+
+// Aggressive batching (500ms) - for non-critical, high volume
+new MyResource(500);
+```
+
+### Caching Strategy
+
+The batching resource automatically caches results:
+
+```typescript
+// First request
+const info1 = resource.resource(123);  // Triggers API call
+
+// Second request (before API returns)
+const info2 = resource.resource(123);  // Reuses same API call
+
+// After API returns
+const info3 = resource.resource(123);  // Reads from cache (no API call)
+
+// Clear cache for item
+resource.reloadKeys([123]);  // Next access triggers new API call
+```
+
+### Performance Characteristics
+
+| Metric | Value | Notes |
+|--------|-------|-------|
+| Batch Window | 50-500ms | Configurable per resource |
+| Cache Duration | Until refs = 0 | Automatic cleanup |
+| Memory Overhead | ~1KB per item | Includes status tracking |
+| Request Reduction | 50-100x | Typical in list views |
+
+## Testing
+
+The library uses **Jest** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test common-data-access --skip-nx-cache
+
+# Run tests with coverage
+npx nx test common-data-access --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test common-data-access --watch
+```
+
+### Test Coverage
+
+The library includes comprehensive tests for:
+
+- **Error Classes** - Instantiation, inheritance, type guards
+- **Response Models** - Type correctness, optional properties
+- **RxJS Operators** - Completion triggers, error transformation
+- **Batching Resource** - Request batching, caching, cleanup
+- **Zod Helpers** - Error message formatting, German translations
+- **AbortSignal Helpers** - Keyboard cancellation
+
+### Example Tests
+
+#### Error Class Testing
+
+```typescript
+import { describe, it, expect } from 'vitest';
+import { DataAccessError, ResponseArgsError } from './errors';
+
+describe('DataAccessError', () => {
+  it('should create error with code and message', () => {
+    class TestError extends DataAccessError<'TEST_ERROR'> {
+      constructor() {
+        super('TEST_ERROR', 'Test message');
+      }
+    }
+
+    const error = new TestError();
+
+    expect(error.code).toBe('TEST_ERROR');
+    expect(error.message).toBe('Test message');
+    expect(error.name).toBe('TestError');
+  });
+
+  it('should support instanceof checks', () => {
+    const error = new ResponseArgsError({
+      error: true,
+      message: 'API error'
+    });
+
+    expect(error instanceof ResponseArgsError).toBe(true);
+    expect(error instanceof DataAccessError).toBe(true);
+    expect(error instanceof Error).toBe(true);
+  });
+});
+```
+
+#### Batching Resource Testing
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { BatchingResource } from './batching-resource.base';
+
+class TestResource extends BatchingResource<number, { ids: number[] }, { id: number; value: string }> {
+  fetchFn = vi.fn();
+
+  protected async fetchFn(params: { ids: number[] }, signal: AbortSignal) {
+    return this.fetchFn(params, signal);
+  }
+
+  protected buildParams(ids: number[]) {
+    return { ids };
+  }
+
+  protected getKeyFromResult(result: { id: number }) {
+    return result.id;
+  }
+
+  protected getCacheKey(id: number) {
+    return String(id);
+  }
+
+  protected extractKeysFromParams(params: { ids: number[] }) {
+    return params.ids;
+  }
+}
+
+describe('BatchingResource', () => {
+  let resource: TestResource;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      providers: [TestResource]
+    });
+    resource = TestBed.inject(TestResource);
+  });
+
+  it('should batch multiple requests', async () => {
+    resource.fetchFn.mockResolvedValue([
+      { id: 1, value: 'one' },
+      { id: 2, value: 'two' }
+    ]);
+
+    const ref1 = resource.resource(1);
+    const ref2 = resource.resource(2);
+
+    // Wait for batch window
+    await new Promise(resolve => setTimeout(resolve, 150));
+
+    expect(resource.fetchFn).toHaveBeenCalledTimes(1);
+    expect(resource.fetchFn).toHaveBeenCalledWith(
+      { ids: [1, 2] },
+      expect.any(AbortSignal)
+    );
+  });
+
+  it('should cache results', async () => {
+    resource.fetchFn.mockResolvedValue([{ id: 1, value: 'one' }]);
+
+    const ref1 = resource.resource(1);
+    await new Promise(resolve => setTimeout(resolve, 150));
+
+    const ref2 = resource.resource(1);  // Should use cache
+
+    expect(resource.fetchFn).toHaveBeenCalledTimes(1);
+  });
+});
+```
+
+## Architecture Notes
+
+### Current Architecture
+
+```
+Domain Services
+       ↓
+Common Data Access (this library)
+       ↓
+├─→ Error Classes (structured error handling)
+├─→ RxJS Operators (request control)
+├─→ Response Models (API contracts)
+├─→ Batching Resources (request optimization)
+└─→ Helper Functions (utilities)
+       ↓
+External Dependencies (RxJS, Zod, Angular)
+```
+
+### Design Patterns
+
+#### 1. Error Hierarchy Pattern
+
+Structured error types with discriminated unions:
+
+```typescript
+// Type-safe error handling
+function handleError(error: unknown) {
+  if (error instanceof ResponseArgsError) {
+    // Compiler knows: error.responseArgs exists
+  } else if (error instanceof PropertyIsEmptyError) {
+    // Compiler knows: error.code === 'PROPERTY_IS_EMPTY'
+  }
+}
+```
+
+#### 2. Operator Composition Pattern
+
+Composable RxJS operators for reusable logic:
+
+```typescript
+const withCancellation = (signal: AbortSignal) =>
+  pipe(
+    takeUntilAborted(signal),
+    catchResponseArgsErrorPipe()
+  );
+```
+
+#### 3. Abstract Resource Pattern
+
+Template method pattern for batching resources:
+
+```typescript
+abstract class BatchingResource {
+  // Template method
+  resource(params) {
+    this.addKeys(params);  // Common logic
+    return this.createRef(params);  // Common logic
+  }
+
+  // Hook methods (implemented by subclasses)
+  protected abstract fetchFn(...);
+  protected abstract buildParams(...);
+}
+```
+
+### Dependencies
+
+#### Required Libraries
+
+- `@angular/core` - Angular framework (signals, resources, DI)
+- `rxjs` - Reactive programming
+- `zod` - Runtime validation (peer dependency)
+
+#### Path Alias
+
+Import from: `@isa/common/data-access`
+
+### Performance Considerations
+
+1. **Batching Window Optimization** - Balance latency vs request reduction
+2. **Cache Memory Management** - Reference counting prevents memory leaks
+3. **Signal-Based Reactivity** - Minimal re-computation with Angular signals
+4. **Operator Efficiency** - Custom operators avoid subscription overhead
+5. **Error Object Reuse** - Error instances don't allocate large objects
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Error Serialization** - Support for transmitting errors across workers
+2. **Retry Strategies** - Built-in exponential backoff for transient failures
+3. **Request Deduplication** - Prevent duplicate requests for same params
+4. **Metrics Collection** - Track batch efficiency and cache hit rates
+5. **Batch Priority Queues** - Prioritize critical requests over background
+6. **Stale-While-Revalidate** - Serve cached data while fetching fresh data
+7. **Offline Support** - Queue requests when network is unavailable
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/common/data-access/src/lib/models/buyer-type.ts b/libs/common/data-access/src/lib/models/buyer-type.ts
deleted file mode 100644
index df18fa9e5..000000000
--- a/libs/common/data-access/src/lib/models/buyer-type.ts
+++ /dev/null
@@ -1,10 +0,0 @@
-export const BuyerType = {
-  NotSet: 0,
-  ContactCustomer: 1,
-  BranchCustomer: 2,
-  Staff: 4,
-  B2C: 8,
-  B2B: 16,
-} as const;
-
-export type BuyerType = (typeof BuyerType)[keyof typeof BuyerType];
diff --git a/libs/common/data-access/src/lib/models/index.ts b/libs/common/data-access/src/lib/models/index.ts
index f8ebe3a04..9ed346153 100644
--- a/libs/common/data-access/src/lib/models/index.ts
+++ b/libs/common/data-access/src/lib/models/index.ts
@@ -1,6 +1,5 @@
 export * from './async-result';
 export * from './batch-response-args';
-export * from './buyer-type';
 export * from './callback-result';
 export * from './entity-cotnainer';
 export * from './entity-status';
diff --git a/libs/common/data-access/src/lib/schemas/address.schema.ts b/libs/common/data-access/src/lib/schemas/address.schema.ts
index 6bb0a5f8c..d35624b2f 100644
--- a/libs/common/data-access/src/lib/schemas/address.schema.ts
+++ b/libs/common/data-access/src/lib/schemas/address.schema.ts
@@ -2,11 +2,11 @@ import z from 'zod';
 
 export const AddressSchema = z
   .object({
-    street: z.string().optional(),
-    streetNumber: z.string().optional(),
-    postalCode: z.string().optional(),
-    city: z.string().optional(),
-    country: z.string().optional(),
-    additionalInfo: z.string().optional(),
+    street: z.string().describe('Street name').optional(),
+    streetNumber: z.string().describe('Street number').optional(),
+    postalCode: z.string().describe('Postal code').optional(),
+    city: z.string().describe('City name').optional(),
+    country: z.string().describe('Country').optional(),
+    additionalInfo: z.string().describe('Additional information').optional(),
   })
   .optional();
diff --git a/libs/common/data-access/src/lib/schemas/addressee-with-reference.schema.ts b/libs/common/data-access/src/lib/schemas/addressee-with-reference.schema.ts
index a090e01e7..c7f39a717 100644
--- a/libs/common/data-access/src/lib/schemas/addressee-with-reference.schema.ts
+++ b/libs/common/data-access/src/lib/schemas/addressee-with-reference.schema.ts
@@ -6,12 +6,12 @@ import { GenderSchema } from './gender.schema';
 import { OrganisationSchema } from './organisation.schema';
 
 export const AddresseeWithReferenceSchema = EntityReferenceSchema.extend({
-  address: AddressSchema.optional(),
-  communicationDetails: CommunicationDetailsSchema.optional(),
-  firstName: z.string().optional(),
-  lastName: z.string().optional(),
-  gender: GenderSchema.optional(),
-  locale: z.string().optional(),
-  organisation: OrganisationSchema.optional(),
-  title: z.string().optional(),
+  address: AddressSchema.describe('Address').optional(),
+  communicationDetails: CommunicationDetailsSchema.describe('Communication details').optional(),
+  firstName: z.string().describe('First name').optional(),
+  lastName: z.string().describe('Last name').optional(),
+  gender: GenderSchema.describe('Gender').optional(),
+  locale: z.string().describe('Locale').optional(),
+  organisation: OrganisationSchema.describe('Organisation information').optional(),
+  title: z.string().describe('Title').optional(),
 });
diff --git a/libs/common/data-access/src/lib/schemas/buyer-type.schema.ts b/libs/common/data-access/src/lib/schemas/buyer-type.schema.ts
new file mode 100644
index 000000000..889b764f5
--- /dev/null
+++ b/libs/common/data-access/src/lib/schemas/buyer-type.schema.ts
@@ -0,0 +1,14 @@
+import { z } from 'zod';
+
+export const BuyerType = {
+  NotSet: 0,
+  ContactCustomer: 1,
+  BranchCustomer: 2,
+  Staff: 4,
+  B2C: 8,
+  B2B: 16,
+} as const;
+
+export const BuyerTypeSchema = z.nativeEnum(BuyerType).describe('Buyer type');
+
+export type BuyerType = z.infer<typeof BuyerTypeSchema>;
diff --git a/libs/common/data-access/src/lib/schemas/communication-details.schema.ts b/libs/common/data-access/src/lib/schemas/communication-details.schema.ts
index ebb48543f..6b212a35c 100644
--- a/libs/common/data-access/src/lib/schemas/communication-details.schema.ts
+++ b/libs/common/data-access/src/lib/schemas/communication-details.schema.ts
@@ -1,8 +1,8 @@
 import z from 'zod';
 
 export const CommunicationDetailsSchema = z.object({
-  email: z.string().optional(),
-  phone: z.string().optional(),
-  mobile: z.string().optional(),
-  fax: z.string().optional(),
+  email: z.string().describe('Email address').optional(),
+  phone: z.string().describe('Phone number').optional(),
+  mobile: z.string().describe('Mobile phone number').optional(),
+  fax: z.string().describe('Fax number').optional(),
 });
diff --git a/libs/common/data-access/src/lib/schemas/entity-container.schema.ts b/libs/common/data-access/src/lib/schemas/entity-container.schema.ts
index b926dc61d..813563389 100644
--- a/libs/common/data-access/src/lib/schemas/entity-container.schema.ts
+++ b/libs/common/data-access/src/lib/schemas/entity-container.schema.ts
@@ -14,5 +14,5 @@ import { EntityReferenceContainerSchema } from './entity-reference-container.sch
  */
 export const EntityContainerSchema = <T extends z.ZodTypeAny>(dataSchema: T) =>
   EntityReferenceContainerSchema.extend({
-    data: dataSchema.optional(),
+    data: dataSchema.describe('Data').optional(),
   });
diff --git a/libs/common/data-access/src/lib/schemas/entity-reference-container.schema.ts b/libs/common/data-access/src/lib/schemas/entity-reference-container.schema.ts
index d9b6702c9..13bda940a 100644
--- a/libs/common/data-access/src/lib/schemas/entity-reference-container.schema.ts
+++ b/libs/common/data-access/src/lib/schemas/entity-reference-container.schema.ts
@@ -1,18 +1,20 @@
 import { z } from 'zod';
-import { ExternalReferenceSchema } from './external-reference.schema';
 
 /**
  * Schema for EntityDTOReferenceContainer
  * Base container type for entity references with metadata
+ *
+ * Note: externalReference uses z.any() to avoid type conflicts between
+ * our optional ExternalReferenceSchema and the generated DTOs which require externalStatus
  */
 export const EntityReferenceContainerSchema = z.object({
-  displayLabel: z.string().optional(),
-  enabled: z.boolean().optional(),
-  externalReference: ExternalReferenceSchema.optional(),
-  id: z.number().optional(),
-  pId: z.string().optional(),
-  selected: z.boolean().optional(),
-  uId: z.string().optional(),
+  displayLabel: z.string().describe('Display label').optional(),
+  enabled: z.boolean().describe('Whether this is enabled').optional(),
+  externalReference: z.any().describe('External system reference').optional(),
+  id: z.number().describe('Unique identifier').optional(),
+  pId: z.string().describe('P identifier').optional(),
+  selected: z.boolean().describe('Whether this option is currently selected').optional(),
+  uId: z.string().describe('U identifier').optional(),
 });
 
 export type EntityReferenceContainer = z.infer<
diff --git a/libs/common/data-access/src/lib/schemas/entity-reference.schema.ts b/libs/common/data-access/src/lib/schemas/entity-reference.schema.ts
index 3f26aa039..3390877f4 100644
--- a/libs/common/data-access/src/lib/schemas/entity-reference.schema.ts
+++ b/libs/common/data-access/src/lib/schemas/entity-reference.schema.ts
@@ -2,7 +2,7 @@ import z from 'zod';
 import { EntityReferenceContainerSchema } from './entity-reference-container.schema';
 
 export const EntityReferenceSchema = z.object({
-  pId: z.string().optional(),
-  reference: EntityReferenceContainerSchema.optional(),
-  source: z.number().optional(),
+  pId: z.string().describe('P identifier').optional(),
+  reference: EntityReferenceContainerSchema.describe('Reference').optional(),
+  source: z.number().describe('Source').optional(),
 });
diff --git a/libs/common/data-access/src/lib/schemas/entity-status.schema.ts b/libs/common/data-access/src/lib/schemas/entity-status.schema.ts
index 807b17ab8..3f2c64599 100644
--- a/libs/common/data-access/src/lib/schemas/entity-status.schema.ts
+++ b/libs/common/data-access/src/lib/schemas/entity-status.schema.ts
@@ -4,4 +4,4 @@ import { EntityStatus } from '../models';
 /**
  * EntityStatus is a bitwise enum with values: 0 | 1 | 2 | 4 | 8
  */
-export const EntityStatusSchema = z.nativeEnum(EntityStatus);
+export const EntityStatusSchema = z.nativeEnum(EntityStatus).describe('Entity status');
diff --git a/libs/common/data-access/src/lib/schemas/entity.schema.ts b/libs/common/data-access/src/lib/schemas/entity.schema.ts
new file mode 100644
index 000000000..47dd801de
--- /dev/null
+++ b/libs/common/data-access/src/lib/schemas/entity.schema.ts
@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { EntityStatusSchema } from './entity-status.schema';
+
+export const EntitySchema = z.object({
+  changed: z.string().describe('Changed').optional(),
+  created: z.string().describe('Created').optional(),
+  id: z.number().int().positive().describe('Unique identifier').optional(),
+  pId: z.string().describe('P identifier').optional(),
+  status: EntityStatusSchema.describe('Current status').optional(),
+  uId: z.string().describe('U identifier').optional(),
+  version: z.number().int().nonnegative().describe('Version').optional(),
+});
diff --git a/libs/common/data-access/src/lib/schemas/external-reference.schema.ts b/libs/common/data-access/src/lib/schemas/external-reference.schema.ts
index 02532d802..fef1276be 100644
--- a/libs/common/data-access/src/lib/schemas/external-reference.schema.ts
+++ b/libs/common/data-access/src/lib/schemas/external-reference.schema.ts
@@ -5,17 +5,24 @@ import { EntityStatusSchema } from './entity-status.schema';
  * Schema for ExternalReferenceDTO
  * Represents external system reference information
  *
- * Note: externalStatus is REQUIRED in all generated ExternalReferenceDTO types
+ * Note: In the generated DTOs, externalStatus is REQUIRED when ExternalReferenceDTO is present.
+ * However, we make all fields optional in this schema because:
+ * 1. This schema is used within EntityReferenceContainerSchema where externalReference itself is optional
+ * 2. When constructing objects, we often omit externalReference entirely
+ * 3. Type compatibility: our inferred types must be assignable to the generated DTOs
+ *
+ * When using this schema to create objects that will be passed to generated API clients,
+ * either omit externalReference entirely OR ensure externalStatus is provided.
  */
 export const ExternalReferenceSchema = z.object({
-  externalChanged: z.string().optional(),
-  externalCreated: z.string().optional(),
-  externalNumber: z.string().optional(),
-  externalPK: z.string().optional(),
-  externalRepository: z.string().optional(),
-  externalStatus: EntityStatusSchema,
-  externalVersion: z.number().optional(),
-  publishToken: z.string().optional(),
+  externalChanged: z.string().describe('External changed').optional(),
+  externalCreated: z.string().describe('External created').optional(),
+  externalNumber: z.string().describe('External number').optional(),
+  externalPK: z.string().describe('External p k').optional(),
+  externalRepository: z.string().describe('External repository').optional(),
+  externalStatus: EntityStatusSchema.describe('External status').optional(),
+  externalVersion: z.number().describe('External version').optional(),
+  publishToken: z.string().describe('Publish token').optional(),
 });
 
 export type ExternalReference = z.infer<typeof ExternalReferenceSchema>;
diff --git a/libs/common/data-access/src/lib/schemas/gender.schema.ts b/libs/common/data-access/src/lib/schemas/gender.schema.ts
index 4dccc7ef4..8619407d5 100644
--- a/libs/common/data-access/src/lib/schemas/gender.schema.ts
+++ b/libs/common/data-access/src/lib/schemas/gender.schema.ts
@@ -1,4 +1,4 @@
 import z from 'zod';
 import { Gender } from '../models';
 
-export const GenderSchema = z.nativeEnum(Gender);
+export const GenderSchema = z.nativeEnum(Gender).describe('Gender');
diff --git a/libs/common/data-access/src/lib/schemas/index.ts b/libs/common/data-access/src/lib/schemas/index.ts
index 21696aa1e..9c8fed279 100644
--- a/libs/common/data-access/src/lib/schemas/index.ts
+++ b/libs/common/data-access/src/lib/schemas/index.ts
@@ -1,15 +1,23 @@
 export * from './address.schema';
 export * from './addressee-with-reference.schema';
+export * from './buyer-type.schema';
 export * from './communication-details.schema';
 export * from './entity-container.schema';
 export * from './entity-reference-container.schema';
 export * from './entity-reference.schema';
 export * from './entity-status.schema';
+export * from './entity.schema';
 export * from './external-reference.schema';
 export * from './gender.schema';
+export * from './key-value.schema';
+export * from './label.schema';
+export * from './notification-channel.schema';
 export * from './organisation-names.schema';
 export * from './organisation.schema';
+export * from './payment-type.schema';
 export * from './price-value.schema';
 export * from './price.schema';
+export * from './quantity-unit-type.schema';
+export * from './touch-base.schema';
 export * from './vat-type.schema';
 export * from './vat-value.schema';
diff --git a/libs/common/data-access/src/lib/schemas/key-value.schema.ts b/libs/common/data-access/src/lib/schemas/key-value.schema.ts
new file mode 100644
index 000000000..6ca7b18a8
--- /dev/null
+++ b/libs/common/data-access/src/lib/schemas/key-value.schema.ts
@@ -0,0 +1,25 @@
+import z from 'zod';
+
+export const KeyValueSchema = <
+  TK extends z.ZodTypeAny,
+  TV extends z.ZodTypeAny,
+>(
+  keySchema: TK,
+  valueSchema: TV,
+) =>
+  z.object({
+    command: z.string().describe('Command').optional(),
+    description: z.string().describe('Description text').optional(),
+    enabled: z.boolean().describe('Whether this is enabled').optional(),
+    group: z.string().describe('Group').optional(),
+    key: keySchema.describe('Key').optional(),
+    label: z.string().describe('Label').optional(),
+    selected: z.boolean().describe('Whether this option is currently selected').optional(),
+    sort: z.number().describe('Sort criteria').optional(),
+    value: valueSchema.describe('Value').optional(),
+  });
+
+export const KeyValueOfStringAndStringSchema = KeyValueSchema(
+  z.string(),
+  z.string(),
+);
diff --git a/libs/common/data-access/src/lib/schemas/label.schema.ts b/libs/common/data-access/src/lib/schemas/label.schema.ts
new file mode 100644
index 000000000..a65101d76
--- /dev/null
+++ b/libs/common/data-access/src/lib/schemas/label.schema.ts
@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { EntitySchema } from './entity.schema';
+
+export const LabelSchema = z
+  .object({
+    key: z.string().describe('Key').optional(),
+    name: z.string().describe('Name').optional(),
+  })
+  .extend(EntitySchema.shape);
diff --git a/libs/common/data-access/src/lib/schemas/notification-channel.schema.ts b/libs/common/data-access/src/lib/schemas/notification-channel.schema.ts
new file mode 100644
index 000000000..3514ac348
--- /dev/null
+++ b/libs/common/data-access/src/lib/schemas/notification-channel.schema.ts
@@ -0,0 +1,14 @@
+import z from 'zod';
+
+export const NotificationChannel = {
+  NotSet: 0,
+  Email: 1,
+  SMS: 2,
+  Phone: 4,
+  Fax: 8,
+  Postal: 16,
+} as const;
+
+export const NotificationChannelSchema = z.nativeEnum(NotificationChannel).describe('Notification channel');
+
+export type NotificationChannel = z.infer<typeof NotificationChannelSchema>;
diff --git a/libs/common/data-access/src/lib/schemas/organisation-names.schema.ts b/libs/common/data-access/src/lib/schemas/organisation-names.schema.ts
index 8d6bdc5e4..bfa773c9e 100644
--- a/libs/common/data-access/src/lib/schemas/organisation-names.schema.ts
+++ b/libs/common/data-access/src/lib/schemas/organisation-names.schema.ts
@@ -1,8 +1,8 @@
 import { z } from 'zod';
 
 export const OrganisationNamesSchema = z.object({
-  department: z.string().optional(),
-  legalForm: z.string().optional(),
-  name: z.string().optional(),
-  nameSuffix: z.string().optional(),
+  department: z.string().describe('Department').optional(),
+  legalForm: z.string().describe('Legal form').optional(),
+  name: z.string().describe('Name').optional(),
+  nameSuffix: z.string().describe('Name suffix').optional(),
 });
diff --git a/libs/common/data-access/src/lib/schemas/organisation.schema.ts b/libs/common/data-access/src/lib/schemas/organisation.schema.ts
index f96580d9a..d11721537 100644
--- a/libs/common/data-access/src/lib/schemas/organisation.schema.ts
+++ b/libs/common/data-access/src/lib/schemas/organisation.schema.ts
@@ -2,8 +2,8 @@ import z from 'zod';
 import { OrganisationNamesSchema } from './organisation-names.schema';
 
 export const OrganisationSchema = OrganisationNamesSchema.extend({
-  costUnit: z.string().optional(),
-  gln: z.string().optional(),
-  sector: z.string().optional(),
-  vatId: z.string().optional(),
+  costUnit: z.string().describe('Cost unit').optional(),
+  gln: z.string().describe('Gln').optional(),
+  sector: z.string().describe('Sector').optional(),
+  vatId: z.string().describe('Vat identifier').optional(),
 });
diff --git a/libs/common/data-access/src/lib/schemas/payment-type.schema.ts b/libs/common/data-access/src/lib/schemas/payment-type.schema.ts
new file mode 100644
index 000000000..76f7d0b15
--- /dev/null
+++ b/libs/common/data-access/src/lib/schemas/payment-type.schema.ts
@@ -0,0 +1,25 @@
+import z from 'zod';
+
+export const PaymentType = {
+  NotSet: 0,
+  WhenCollecting: 1,
+  Free: 2,
+  Cash: 4,
+  DirectDebit: 8,
+  DebitAdviceMandate: 16,
+  DebitCard: 32,
+  CreditCard: 64,
+  Invoice: 128,
+  PrePayment: 256,
+  Voucher: 512,
+  CollectiveInvoice: 1024,
+  PayPal: 2048,
+  InstantTransfer: 4096,
+  PayOnDelivery: 8192,
+  BonusCard: 16384,
+  AmazonPay: 32768,
+} as const;
+
+export const PaymentTypeSchema = z.nativeEnum(PaymentType).describe('Payment type');
+
+export type PaymentType = z.infer<typeof PaymentTypeSchema>;
diff --git a/libs/common/data-access/src/lib/schemas/price-value.schema.ts b/libs/common/data-access/src/lib/schemas/price-value.schema.ts
index cfd3f8101..8ee1e4c66 100644
--- a/libs/common/data-access/src/lib/schemas/price-value.schema.ts
+++ b/libs/common/data-access/src/lib/schemas/price-value.schema.ts
@@ -1,7 +1,7 @@
-import z from 'zod';
+import { z } from 'zod';
 
 export const PriceValueSchema = z.object({
-  value: z.number().optional(),
-  currency: z.string().optional(),
-  currencySymbol: z.string().optional(),
+  value: z.number().describe('Value').optional(),
+  currency: z.string().describe('Currency code').optional(),
+  currencySymbol: z.string().describe('Currency symbol').optional(),
 });
diff --git a/libs/common/data-access/src/lib/schemas/price.schema.ts b/libs/common/data-access/src/lib/schemas/price.schema.ts
index 5f045cdf6..99c4fb743 100644
--- a/libs/common/data-access/src/lib/schemas/price.schema.ts
+++ b/libs/common/data-access/src/lib/schemas/price.schema.ts
@@ -1,4 +1,4 @@
-import z from 'zod';
+import { z } from 'zod';
 import { PriceValueSchema } from './price-value.schema';
 import { VatValueSchema } from './vat-value.schema';
 
@@ -55,6 +55,6 @@ import { VatValueSchema } from './vat-value.schema';
 // Effort: ~4 hours | Impact: High | Risk: Low
 // See: complexity-analysis.md (TypeScript Section, Issue 5)
 export const PriceSchema = z.object({
-  value: PriceValueSchema.optional(),
-  vat: VatValueSchema.optional(),
+  value: PriceValueSchema.describe('Value').optional(),
+  vat: VatValueSchema.describe('Value Added Tax').optional(),
 });
diff --git a/libs/common/data-access/src/lib/schemas/quantity-unit-type.schema.ts b/libs/common/data-access/src/lib/schemas/quantity-unit-type.schema.ts
new file mode 100644
index 000000000..83a4cf48d
--- /dev/null
+++ b/libs/common/data-access/src/lib/schemas/quantity-unit-type.schema.ts
@@ -0,0 +1,18 @@
+import { z } from 'zod';
+
+export const QuantityUnitType = {
+  NotSet: 0,
+  Pieces: 1,
+  Weight: 2,
+  Length: 4,
+  Area: 8,
+  Volume: 16,
+  DigitalSize: 32,
+  Time: 64,
+  Resolution: 128,
+  Money: 256,
+} as const;
+
+export const QuantityUnitTypeSchema = z.nativeEnum(QuantityUnitType).describe('QuantityUnit type');
+
+export type QuantityUnitType = z.infer<typeof QuantityUnitTypeSchema>;
diff --git a/libs/common/data-access/src/lib/schemas/touch-base.schema.ts b/libs/common/data-access/src/lib/schemas/touch-base.schema.ts
new file mode 100644
index 000000000..cd2d64be7
--- /dev/null
+++ b/libs/common/data-access/src/lib/schemas/touch-base.schema.ts
@@ -0,0 +1,3 @@
+import { z } from 'zod';
+
+export const TouchBaseSchema = z.object({});
diff --git a/libs/common/data-access/src/lib/schemas/vat-type.schema.ts b/libs/common/data-access/src/lib/schemas/vat-type.schema.ts
index ecfaa8eb0..dae49cbcf 100644
--- a/libs/common/data-access/src/lib/schemas/vat-type.schema.ts
+++ b/libs/common/data-access/src/lib/schemas/vat-type.schema.ts
@@ -1,4 +1,4 @@
 import z from 'zod';
 import { VatType } from '../models';
 
-export const VatTypeSchema = z.nativeEnum(VatType).optional();
+export const VatTypeSchema = z.nativeEnum(VatType).optional().describe('Vat type');
diff --git a/libs/common/data-access/src/lib/schemas/vat-value.schema.ts b/libs/common/data-access/src/lib/schemas/vat-value.schema.ts
index 0b39a9dae..2779072d0 100644
--- a/libs/common/data-access/src/lib/schemas/vat-value.schema.ts
+++ b/libs/common/data-access/src/lib/schemas/vat-value.schema.ts
@@ -2,8 +2,8 @@ import z from 'zod';
 import { VatTypeSchema } from './vat-type.schema';
 
 export const VatValueSchema = z.object({
-  value: z.number().optional(),
-  label: z.string().optional(),
-  inPercent: z.number().optional(),
-  vatType: VatTypeSchema.optional(),
+  value: z.number().describe('Value').optional(),
+  label: z.string().describe('Label').optional(),
+  inPercent: z.number().describe('In percent').optional(),
+  vatType: VatTypeSchema.describe('VAT type').optional(),
 });
diff --git a/libs/common/print/README.md b/libs/common/print/README.md
index 62b00ff40..54d47873e 100644
--- a/libs/common/print/README.md
+++ b/libs/common/print/README.md
@@ -1,7 +1,891 @@
-# common-print
+# @isa/common/print
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive print management library for Angular applications providing printer discovery, selection, and unified print operations across label and office printers.
 
-## Running unit tests
+## Overview
 
-Run `nx test common-print` to execute the unit tests.
+The Common Print library provides a platform-aware print service that simplifies printer management and print operations in the ISA application. It supports both label printers (for shipping labels, product tags) and office printers (for documents, receipts), with intelligent fallback strategies and user-friendly printer selection dialogs. The library seamlessly integrates with the print API backend and provides reusable components for consistent print UX across the application.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Platform Behavior](#platform-behavior)
+- [Component Reference](#component-reference)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Dual printer type support** - Label printers and office printers with dedicated endpoints
+- **Platform-aware behavior** - Automatic direct printing on desktop, dialog on mobile
+- **Smart printer selection** - Remembers default printer per type, fallback to dialog if needed
+- **Reusable UI components** - Print button component with integrated state management
+- **Print dialog** - User-friendly printer selection with error display and retry logic
+- **Error handling** - Graceful fallback from direct print to dialog on failures
+- **TypeScript type safety** - Strongly typed printer models and API interfaces
+- **Angular CDK integration** - Platform detection for iOS/Android awareness
+- **Standalone components** - Modern Angular architecture with explicit imports
+
+## Quick Start
+
+### 1. Import and Inject the Service
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { PrintService, PrinterType } from '@isa/common/print';
+
+@Component({
+  selector: 'app-shipping-label',
+  template: '...'
+})
+export class ShippingLabelComponent {
+  #printService = inject(PrintService);
+}
+```
+
+### 2. Simple Direct Print (Platform-Aware)
+
+```typescript
+async printLabel(): Promise<void> {
+  const result = await this.#printService.print({
+    printerType: PrinterType.LABEL,
+    printFn: async (printer) => {
+      // Your print logic here
+      await this.#labelPrintApi.print(printer.key, this.labelData);
+    }
+  });
+
+  if (result.printer) {
+    console.log(`Printed to: ${result.printer.value}`);
+  } else {
+    console.log('Print cancelled by user');
+  }
+}
+```
+
+### 3. Force Print Dialog
+
+```typescript
+async printWithDialog(): Promise<void> {
+  const result = await this.#printService.print({
+    printerType: PrinterType.OFFICE,
+    printFn: async (printer) => {
+      await this.#documentPrintApi.print(printer.key, this.document);
+    },
+    directPrint: false // Always show dialog
+  });
+}
+```
+
+### 4. Use the Print Button Component
+
+```typescript
+import { Component } from '@angular/core';
+import { PrintButtonComponent, PrinterType } from '@isa/common/print';
+
+@Component({
+  selector: 'app-invoice',
+  template: `
+    <common-print-button
+      [printerType]="PrinterType.OFFICE"
+      [printFn]="printInvoice"
+      [directPrint]="false">
+      Rechnung drucken
+    </common-print-button>
+  `,
+  imports: [PrintButtonComponent]
+})
+export class InvoiceComponent {
+  PrinterType = PrinterType;
+
+  printInvoice = async (printer: Printer) => {
+    await this.#api.printInvoice(printer.key, this.invoiceId);
+  };
+}
+```
+
+## Core Concepts
+
+### Printer Types
+
+The library supports two distinct printer categories:
+
+#### 1. Label Printers (`PrinterType.LABEL`)
+- **Purpose**: Specialized thermal label printers for shipping labels, product tags, barcodes
+- **API Endpoint**: `PrintLabelPrinters()`
+- **Common Use Cases**: Shipping labels, warehouse labels, product tags, return labels
+- **Typical Printers**: Zebra, Dymo label printers
+
+#### 2. Office Printers (`PrinterType.OFFICE`)
+- **Purpose**: Standard laser/inkjet printers for documents and receipts
+- **API Endpoint**: `PrintOfficePrinters()`
+- **Common Use Cases**: Invoices, receipts, reports, customer documents
+- **Typical Printers**: HP, Canon, Epson office printers
+
+### Printer Model
+
+All printers share a common interface:
+
+```typescript
+interface Printer {
+  /** Unique identifier for the printer (printer name/ID) */
+  key: string;
+
+  /** Display name shown to users */
+  value: string;
+
+  /** Whether this printer is currently selected as default */
+  selected: boolean;
+
+  /** Whether this printer is currently enabled for use */
+  enabled: boolean;
+}
+```
+
+### Platform-Aware Printing
+
+The library automatically adapts behavior based on platform:
+
+**Desktop (Windows, macOS, Linux)**:
+- Attempts direct print to selected default printer
+- Falls back to dialog only on errors
+- Optimizes for speed and minimal user interaction
+
+**Mobile (Android, iOS)**:
+- Always shows printer selection dialog
+- No direct print due to platform limitations
+- Ensures user has control over print destination
+
+**Platform Detection**:
+```typescript
+const isMobile = this.#platform.ANDROID || this.#platform.IOS;
+const allowDirectPrint = !isMobile && selectedPrinter;
+```
+
+### Print Flow States
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ Print Requested                                             │
+└────────────────┬────────────────────────────────────────────┘
+                 │
+                 ▼
+┌─────────────────────────────────────────────────────────────┐
+│ Fetch Available Printers (Label or Office)                  │
+└────────────────┬────────────────────────────────────────────┘
+                 │
+                 ▼
+          ┌──────┴──────┐
+          │             │
+    Desktop?      Mobile?
+          │             │
+          ▼             ▼
+  ┌──────────────┐  ┌─────────────────┐
+  │ Direct Print │  │ Show Dialog     │
+  │ (if selected)│  │ (always)        │
+  └──────┬───────┘  └─────────┬───────┘
+         │                    │
+    Success?                  │
+         │                    │
+    ┌────┴────┐               │
+    │         │               │
+   Yes       No               │
+    │         │               │
+    │         └───────────────┘
+    │                │
+    ▼                ▼
+  Return       ┌─────────────────┐
+  Printer      │ User Selects    │
+               │ & Prints        │
+               └────────┬────────┘
+                        │
+                   ┌────┴────┐
+                   │         │
+              Success?    Cancel?
+                   │         │
+                   ▼         ▼
+               Return     Return
+               Printer    undefined
+```
+
+### Direct Print Control
+
+The `directPrint` parameter offers fine-grained control:
+
+| Value | Behavior |
+|-------|----------|
+| `undefined` (default) | Platform-aware: direct print on desktop with selected printer, dialog on mobile |
+| `true` | **Always** attempt direct print (requires selected printer, throws error if none) |
+| `false` | **Always** show dialog, even on desktop with selected printer |
+
+## API Reference
+
+### PrintService
+
+Main service for printer discovery and print operations.
+
+#### `labelPrinters(): Promise<Printer[]>`
+
+Retrieves all available label printers from the print API.
+
+**Returns:** Promise resolving to array of label printers
+
+**Example:**
+```typescript
+const labelPrinters = await this.#printService.labelPrinters();
+labelPrinters.forEach(printer => {
+  console.log(`${printer.value} - ${printer.selected ? 'Default' : 'Available'}`);
+});
+```
+
+#### `officePrinters(): Promise<Printer[]>`
+
+Retrieves all available office printers from the print API.
+
+**Returns:** Promise resolving to array of office printers
+
+**Example:**
+```typescript
+const officePrinters = await this.#printService.officePrinters();
+const defaultPrinter = officePrinters.find(p => p.selected);
+```
+
+#### `printers(printerType: PrinterType): Promise<Printer[]>`
+
+Generic method to retrieve printers of a specific type.
+
+**Parameters:**
+- `printerType: PrinterType` - The type of printers to retrieve
+
+**Returns:** Promise resolving to array of printers
+
+**Example:**
+```typescript
+const printers = await this.#printService.printers(PrinterType.LABEL);
+```
+
+#### `print(options): Promise<{ printer?: Printer }>`
+
+Initiates a print operation with intelligent platform-aware behavior.
+
+**Parameters:**
+- `options.printerType: PrinterType` - The type of printer to use
+- `options.printFn: (printer: Printer) => PromiseLike<unknown>` - Function that performs the actual print
+- `options.directPrint?: boolean | undefined` - Direct print control (see [Direct Print Control](#direct-print-control))
+
+**Returns:** Promise resolving to object with selected printer (or undefined if cancelled)
+
+**Throws:**
+- Error from `printFn` if direct print fails and `directPrint: true`
+- Errors propagate to dialog for retry if `directPrint` is undefined
+
+**Example:**
+```typescript
+const result = await this.#printService.print({
+  printerType: PrinterType.LABEL,
+  printFn: async (printer) => {
+    await this.#api.printLabel(printer.key, labelData);
+  },
+  directPrint: undefined // Platform-aware
+});
+
+if (result.printer) {
+  this.#logger.info(`Label printed to ${result.printer.value}`);
+}
+```
+
+### PrinterType
+
+Enum-like object for printer type constants.
+
+**Values:**
+- `PrinterType.LABEL = 'label'` - Label printer type
+- `PrinterType.OFFICE = 'office'` - Office printer type
+
+**Type:**
+```typescript
+type PrinterType = 'label' | 'office';
+```
+
+**Example:**
+```typescript
+import { PrinterType } from '@isa/common/print';
+
+if (printerType === PrinterType.LABEL) {
+  // Handle label printing
+}
+```
+
+## Usage Examples
+
+### Basic Label Printing
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { PrintService, PrinterType } from '@isa/common/print';
+import { logger } from '@isa/core/logging';
+
+@Component({
+  selector: 'app-shipping',
+  template: `
+    <button (click)="printShippingLabel()">
+      Print Shipping Label
+    </button>
+  `
+})
+export class ShippingComponent {
+  #printService = inject(PrintService);
+  #logger = logger(() => ({ component: 'ShippingComponent' }));
+
+  async printShippingLabel(): Promise<void> {
+    try {
+      const result = await this.#printService.print({
+        printerType: PrinterType.LABEL,
+        printFn: async (printer) => {
+          await this.#shippingApi.printLabel({
+            printerId: printer.key,
+            orderId: this.orderId,
+            trackingNumber: this.trackingNumber
+          });
+        }
+      });
+
+      if (result.printer) {
+        this.#logger.info(`Shipping label printed to ${result.printer.value}`);
+      }
+    } catch (error) {
+      this.#logger.error('Failed to print shipping label', error as Error);
+    }
+  }
+}
+```
+
+### Invoice Printing with Forced Dialog
+
+```typescript
+async printInvoice(): Promise<void> {
+  // Always show dialog to let user choose printer
+  const result = await this.#printService.print({
+    printerType: PrinterType.OFFICE,
+    printFn: async (printer) => {
+      await this.#documentApi.printInvoice(
+        printer.key,
+        this.invoiceId,
+        { copies: 2 }
+      );
+    },
+    directPrint: false // Force dialog even on desktop
+  });
+
+  if (result.printer) {
+    this.showSuccessMessage(`Invoice printed to ${result.printer.value}`);
+  }
+}
+```
+
+### Checking Available Printers
+
+```typescript
+import { Component, OnInit, inject, signal } from '@angular/core';
+import { PrintService, Printer, PrinterType } from '@isa/common/print';
+
+@Component({
+  selector: 'app-printer-status',
+  template: `
+    <h3>Available Label Printers</h3>
+    @for (printer of labelPrinters(); track printer.key) {
+      <div>
+        {{ printer.value }}
+        @if (printer.selected) {
+          <span>(Default)</span>
+        }
+        @if (!printer.enabled) {
+          <span>(Offline)</span>
+        }
+      </div>
+    }
+  `
+})
+export class PrinterStatusComponent implements OnInit {
+  #printService = inject(PrintService);
+
+  labelPrinters = signal<Printer[]>([]);
+
+  async ngOnInit(): Promise<void> {
+    const printers = await this.#printService.labelPrinters();
+    this.labelPrinters.set(printers);
+  }
+}
+```
+
+### Print Button with Custom Styling
+
+```typescript
+import { Component } from '@angular/core';
+import { PrintButtonComponent, PrinterType, Printer } from '@isa/common/print';
+
+@Component({
+  selector: 'app-receipt',
+  template: `
+    <div class="receipt-actions">
+      <common-print-button
+        [printerType]="PrinterType.OFFICE"
+        [printFn]="printReceipt"
+        [directPrint]="allowDirectPrint"
+        class="receipt-print-button">
+        <ng-icon name="isaActionPrinter" class="mr-2"></ng-icon>
+        Bon drucken
+      </common-print-button>
+    </div>
+  `,
+  styles: [`
+    .receipt-print-button {
+      width: 100%;
+      justify-content: center;
+    }
+  `],
+  imports: [PrintButtonComponent]
+})
+export class ReceiptComponent {
+  PrinterType = PrinterType;
+  allowDirectPrint = true;
+
+  printReceipt = async (printer: Printer): Promise<void> => {
+    await this.#receiptApi.print({
+      printerId: printer.key,
+      receiptId: this.receiptId,
+      format: 'thermal'
+    });
+  };
+}
+```
+
+### Error Handling with Retry Logic
+
+```typescript
+async printWithRetry(maxRetries = 3): Promise<void> {
+  let attempts = 0;
+
+  while (attempts < maxRetries) {
+    try {
+      const result = await this.#printService.print({
+        printerType: PrinterType.LABEL,
+        printFn: async (printer) => {
+          await this.#api.printLabel(printer.key, this.labelData);
+        }
+      });
+
+      if (result.printer) {
+        this.#logger.info(`Print successful on attempt ${attempts + 1}`);
+        return;
+      } else {
+        // User cancelled
+        this.#logger.info('Print cancelled by user');
+        return;
+      }
+    } catch (error) {
+      attempts++;
+      this.#logger.warn(`Print attempt ${attempts} failed`, error as Error);
+
+      if (attempts >= maxRetries) {
+        this.showErrorMessage('Print failed after multiple attempts');
+        throw error;
+      }
+
+      // Wait before retry
+      await new Promise(resolve => setTimeout(resolve, 1000));
+    }
+  }
+}
+```
+
+### Conditional Printer Type Selection
+
+```typescript
+import { Component, computed, signal } from '@angular/core';
+import { PrintButtonComponent, PrinterType } from '@isa/common/print';
+
+@Component({
+  selector: 'app-document',
+  template: `
+    <label>
+      <input type="checkbox" [(ngModel)]="useLabel" />
+      Print on label printer
+    </label>
+
+    <common-print-button
+      [printerType]="printerType()"
+      [printFn]="printDocument">
+      Print Document
+    </common-print-button>
+  `,
+  imports: [PrintButtonComponent]
+})
+export class DocumentComponent {
+  useLabel = signal(false);
+
+  printerType = computed(() =>
+    this.useLabel()
+      ? PrinterType.LABEL
+      : PrinterType.OFFICE
+  );
+
+  printDocument = async (printer: Printer): Promise<void> => {
+    await this.#api.print({
+      printerId: printer.key,
+      documentId: this.documentId,
+      format: this.useLabel() ? 'label' : 'a4'
+    });
+  };
+}
+```
+
+## Platform Behavior
+
+### Desktop Platforms (Windows, macOS, Linux)
+
+**Default Behavior** (`directPrint: undefined`):
+1. Fetches available printers for the specified type
+2. Identifies the default printer (where `selected: true`)
+3. If a default printer exists:
+   - Attempts direct print to that printer
+   - On success: Returns immediately with the printer
+   - On error: Shows dialog with error message for retry
+4. If no default printer:
+   - Shows printer selection dialog immediately
+
+**Forced Direct Print** (`directPrint: true`):
+- Throws error if no selected printer exists
+- Does not show dialog on failure (error propagates to caller)
+
+**Forced Dialog** (`directPrint: false`):
+- Always shows dialog regardless of selected printer
+- Useful for user confirmation or when switching printers
+
+### Mobile Platforms (Android, iOS)
+
+**All Cases**:
+- Always shows printer selection dialog
+- Direct print is never attempted (platform limitations)
+- `directPrint` parameter is effectively ignored
+- User must manually confirm printer selection
+
+**Platform Detection**:
+```typescript
+// Angular CDK Platform service
+const isMobile = this.#platform.ANDROID || this.#platform.IOS;
+```
+
+### Print Dialog Features
+
+When the dialog is shown:
+- **Printer List**: All available printers with selection state
+- **Default Preselection**: Default printer is pre-selected
+- **Status Indicators**: Shows enabled/disabled state
+- **Error Display**: Shows errors from failed direct print attempts
+- **Retry Logic**: Allows user to select different printer and retry
+- **Cancel Option**: Returns `undefined` if user cancels
+
+## Component Reference
+
+### PrintButtonComponent
+
+Reusable button component with integrated print functionality and state management.
+
+**Selector:** `common-print-button`
+
+**Inputs:**
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| `printerType` | `PrinterType` | Yes | The type of printer to use (LABEL or OFFICE) |
+| `printFn` | `(printer: Printer) => PromiseLike<void>` | Yes | Function that executes the print logic |
+| `directPrint` | `boolean \| undefined` | No | Controls direct print behavior (default: platform-aware) |
+
+**Outputs:** None (uses signals for state)
+
+**Signals:**
+- `printing: Signal<boolean>` - Indicates if a print operation is in progress
+
+**Content Projection:**
+- Supports transcluded content for button label
+- Includes printer icon by default
+
+**Example:**
+```typescript
+<common-print-button
+  [printerType]="PrinterType.LABEL"
+  [printFn]="myPrintFunction"
+  [directPrint]="false">
+  Custom Button Text
+</common-print-button>
+```
+
+**Features:**
+- Automatic loading state management via `printing` signal
+- Error logging to ISA logging service
+- Disables button during print operations
+- Printer icon from `@isa/icons`
+
+### PrintDialogComponent
+
+Internal dialog component for printer selection (not typically used directly).
+
+**Selector:** `common-print-dialog`
+
+**Data Interface:**
+```typescript
+interface PrinterDialogData {
+  printers: Printer[];
+  error?: unknown;
+  print: (printer: Printer) => PromiseLike<unknown>;
+}
+```
+
+**Result Interface:**
+```typescript
+interface PrinterDialogResult {
+  printer: Printer | undefined;
+}
+```
+
+**Features:**
+- Listbox for printer selection
+- Default printer preselection
+- Error display with formatting
+- Print button with loading state
+- Cancel button
+
+**Usage (via PrintService):**
+```typescript
+// Dialog is automatically shown by PrintService
+// No need to use directly
+```
+
+## Testing
+
+The library uses **Jest** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test common-print --skip-nx-cache
+
+# Run tests with coverage
+npx nx test common-print --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test common-print --watch
+```
+
+### Test Structure
+
+The library includes unit tests covering:
+
+- **Service Methods** - Printer fetching and print orchestration
+- **Platform Detection** - Mobile vs desktop behavior
+- **Direct Print Logic** - Default printer selection and fallback
+- **Error Handling** - Dialog display on failures
+- **Component State** - Print button loading states
+- **Dialog Interaction** - Printer selection and print execution
+
+### Example Test
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { Platform } from '@angular/cdk/platform';
+import { PrintService } from './print.service';
+import { PrintService as PrintApiService } from '@generated/swagger/print-api';
+
+describe('PrintService', () => {
+  let service: PrintService;
+  let mockPrintApi: jest.Mocked<PrintApiService>;
+  let mockPlatform: jest.Mocked<Platform>;
+
+  beforeEach(() => {
+    mockPrintApi = {
+      PrintLabelPrinters: jest.fn(),
+      PrintOfficePrinters: jest.fn()
+    } as any;
+
+    mockPlatform = {
+      ANDROID: false,
+      IOS: false
+    } as any;
+
+    TestBed.configureTestingModule({
+      providers: [
+        PrintService,
+        { provide: PrintApiService, useValue: mockPrintApi },
+        { provide: Platform, useValue: mockPlatform }
+      ]
+    });
+
+    service = TestBed.inject(PrintService);
+  });
+
+  it('should fetch label printers', async () => {
+    const mockPrinters = [
+      { key: 'printer1', value: 'Label Printer 1', selected: true, enabled: true }
+    ];
+
+    mockPrintApi.PrintLabelPrinters.mockReturnValue(
+      of({ result: mockPrinters })
+    );
+
+    const printers = await service.labelPrinters();
+
+    expect(printers).toEqual(mockPrinters);
+    expect(mockPrintApi.PrintLabelPrinters).toHaveBeenCalled();
+  });
+
+  it('should attempt direct print on desktop with selected printer', async () => {
+    // Test implementation...
+  });
+});
+```
+
+## Architecture Notes
+
+### Current Architecture
+
+```
+Components/Features
+       ↓
+  PrintButtonComponent (optional, reusable UI)
+       ↓
+  PrintService (main orchestration)
+       ↓
+├─→ PrintDialogComponent (printer selection UI)
+├─→ Platform (CDK platform detection)
+└─→ PrintApiService (generated API client)
+```
+
+### Design Patterns
+
+#### 1. Strategy Pattern (Platform-Aware Behavior)
+
+The service uses platform detection to choose the appropriate print strategy:
+
+```typescript
+const directPrintAllowed =
+  directPrint === undefined
+    ? selectedPrinter && !(this.#platform.ANDROID || this.#platform.IOS)
+    : directPrint;
+```
+
+**Benefits:**
+- Single API for all platforms
+- Automatic optimization per platform
+- Easy to test with mocked Platform service
+
+#### 2. Facade Pattern (Unified Print API)
+
+PrintService provides a simplified interface over complex printer management:
+
+```typescript
+// Simple API hides:
+// - Printer discovery
+// - Platform detection
+// - Dialog management
+// - Error recovery
+await this.#printService.print({ printerType, printFn });
+```
+
+#### 3. Dependency Injection (Modern Angular)
+
+Uses `inject()` function for clean service composition:
+
+```typescript
+#printService = inject(PrintApiService);
+#printDialog = injectDialog(PrintDialogComponent, { title: 'Drucken' });
+#platform = inject(Platform);
+```
+
+### Known Architectural Considerations
+
+#### 1. Dialog Integration (Low Priority)
+
+**Current State:**
+- Dialog is injected via `injectDialog()` from `@isa/ui/dialog`
+- Dialog component is tightly coupled to service
+
+**Potential Improvement:**
+- Consider injectable dialog strategy for testing
+- Allows mocking dialog interactions in unit tests
+
+**Impact:** Low - current design works well for production use
+
+#### 2. Print Function Type Safety (Medium Priority)
+
+**Current State:**
+- `printFn` accepts any PromiseLike return type
+- No type enforcement on print API contract
+
+**Potential Improvement:**
+```typescript
+interface PrintFunction<TData> {
+  (printer: Printer, data: TData): PromiseLike<void>;
+}
+```
+
+**Impact:** Medium - would improve type safety at call sites
+
+#### 3. Printer Caching (Low Priority)
+
+**Current State:**
+- Fetches printers on every print operation
+- No caching layer
+
+**Potential Improvement:**
+- Cache printers for short duration (60 seconds)
+- Invalidate on print errors (printer might be offline)
+- Reduces API calls for rapid print operations
+
+**Impact:** Low - current performance is acceptable
+
+### Dependencies
+
+#### Required Libraries
+
+- `@angular/core` - Angular framework
+- `@angular/cdk/platform` - Platform detection
+- `@generated/swagger/print-api` - Generated print API client
+- `@isa/ui/dialog` - Dialog system
+- `@isa/ui/buttons` - Button components
+- `@isa/ui/input-controls` - Listbox component
+- `@isa/icons` - Icon library
+- `@isa/core/logging` - Logging service
+- `rxjs` - Reactive programming
+
+#### Path Alias
+
+Import from: `@isa/common/print`
+
+### Performance Considerations
+
+1. **Lazy Dialog Loading** - Dialog component only loaded when needed
+2. **Platform Detection Caching** - Platform service caches detection results
+3. **First Value Resolution** - Uses `firstValueFrom()` for clean Promise conversion
+4. **Component OnPush** - All components use OnPush change detection
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Print History** - Track recent print operations for audit trail
+2. **Printer Status Polling** - Real-time printer availability updates
+3. **Print Preview** - Optional preview before printing (office printers)
+4. **Batch Printing** - Print multiple documents to same printer
+5. **Print Queue** - Queue multiple print jobs for sequential processing
+6. **Custom Paper Sizes** - Support for custom paper size selection (label printers)
+7. **Print Templates** - Reusable print configurations per printer type
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/core/config/README.md b/libs/core/config/README.md
index 3fcab5cd0..16a2b1545 100644
--- a/libs/core/config/README.md
+++ b/libs/core/config/README.md
@@ -1,7 +1,1154 @@
-# core-config
+# @isa/core/config
 
-This library was generated with [Nx](https://nx.dev).
+A lightweight, type-safe configuration management system for Angular applications with runtime validation and nested object access.
 
-## Running unit tests
+## Overview
 
-Run `nx test core-config` to execute the unit tests.
+The Core Config library provides a simple yet powerful configuration service for Angular applications. It enables type-safe access to application configuration data with Zod schema validation, supports nested object navigation with dot notation, and integrates seamlessly with Angular's dependency injection system. The library is designed for runtime configuration that needs to be injected at application startup from external sources like environment files or remote configuration servers.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Configuration Patterns](#configuration-patterns)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Type-safe configuration** - Zod schema validation for runtime safety
+- **Nested object access** - Dot notation for deep property paths
+- **Dependency injection** - Angular injection token integration
+- **Flexible data structure** - Support for primitives, arrays, and objects
+- **Array coercion** - Automatic handling of string or array paths
+- **Runtime validation** - Validate configuration at runtime with schemas
+- **Lightweight** - Minimal dependencies, simple implementation
+- **JSON-compatible** - Works with standard JSON configuration data
+
+## Quick Start
+
+### 1. Provide Configuration Data
+
+```typescript
+import { ApplicationConfig } from '@angular/core';
+import { CONFIG_DATA } from '@isa/core/config';
+
+const appConfig = {
+  api: {
+    baseUrl: 'https://api.example.com',
+    timeout: 30000,
+    retries: 3
+  },
+  features: {
+    enableBeta: false,
+    maxUploadSize: 10485760
+  },
+  branding: {
+    appName: 'My Application',
+    theme: 'light'
+  }
+};
+
+export const config: ApplicationConfig = {
+  providers: [
+    {
+      provide: CONFIG_DATA,
+      useValue: appConfig
+    }
+  ]
+};
+```
+
+### 2. Inject and Use Config Service
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Config } from '@isa/core/config';
+import { z } from 'zod';
+
+@Component({
+  selector: 'app-root',
+  template: '...'
+})
+export class AppComponent {
+  #config = inject(Config);
+
+  // Access with validation
+  apiConfig = this.#config.get(
+    'api',
+    z.object({
+      baseUrl: z.string().url(),
+      timeout: z.number().positive(),
+      retries: z.number().int().min(0)
+    })
+  );
+
+  // Access nested property
+  appName = this.#config.get('branding.appName', z.string());
+
+  ngOnInit() {
+    console.log(`API URL: ${this.apiConfig.baseUrl}`);
+    console.log(`App name: ${this.appName}`);
+  }
+}
+```
+
+### 3. Access Without Validation (Deprecated)
+
+```typescript
+// Not recommended - use Zod schema instead
+const rawValue = this.#config.get('api.baseUrl');  // any type
+```
+
+## Core Concepts
+
+### Configuration Data Structure
+
+The configuration data must be JSON-compatible:
+
+```typescript
+type JsonPrimitive = string | number | boolean | null | undefined;
+
+type JsonValue =
+  | Array<JsonPrimitive>
+  | Record<string, JsonPrimitive>
+  | JsonPrimitive;
+```
+
+**Supported Types:**
+- **Primitives**: string, number, boolean, null, undefined
+- **Objects**: Records with primitive values
+- **Arrays**: Arrays of primitives
+
+**Example Configuration:**
+```typescript
+const config = {
+  // Primitives
+  appName: 'ISA Frontend',
+  port: 8080,
+  debugMode: true,
+
+  // Nested objects
+  database: {
+    host: 'localhost',
+    port: 5432,
+    name: 'mydb'
+  },
+
+  // Arrays
+  allowedOrigins: ['http://localhost:4200', 'https://example.com'],
+
+  // Nested with arrays
+  features: {
+    enabled: ['auth', 'reporting', 'analytics']
+  }
+};
+```
+
+### Dot Notation Access
+
+Access nested properties using dot notation:
+
+```typescript
+// Direct property
+this.#config.get('appName', z.string());
+
+// Nested property
+this.#config.get('database.host', z.string());
+
+// Deep nesting
+this.#config.get('features.beta.settings.maxUsers', z.number());
+```
+
+**Path Resolution:**
+```typescript
+// String path
+'database.host'  →  config.database.host
+
+// Array path (equivalent)
+['database', 'host']  →  config.database.host
+
+// Mixed array path
+['features', 'beta', 'settings']  →  config.features.beta.settings
+```
+
+### Zod Schema Validation
+
+All configuration access should use Zod schemas for type safety:
+
+```typescript
+import { z } from 'zod';
+
+// Simple primitive
+const port = this.#config.get('port', z.number());
+
+// Object with validation
+const dbConfig = this.#config.get(
+  'database',
+  z.object({
+    host: z.string().min(1),
+    port: z.number().int().positive(),
+    name: z.string()
+  })
+);
+
+// Array with validation
+const origins = this.#config.get(
+  'allowedOrigins',
+  z.array(z.string().url())
+);
+
+// Optional values
+const optionalFeature = this.#config.get(
+  'features.experimental',
+  z.string().optional()
+);
+
+// Default values
+const timeout = this.#config.get(
+  'api.timeout',
+  z.number().default(30000)
+);
+```
+
+## API Reference
+
+### CONFIG_DATA
+
+Injection token for providing configuration data.
+
+**Type:** `InjectionToken<JsonValue>`
+
+**Usage:**
+```typescript
+import { CONFIG_DATA } from '@isa/core/config';
+
+{
+  provide: CONFIG_DATA,
+  useValue: myConfigObject
+}
+```
+
+### Config Service
+
+Injectable service for accessing configuration data.
+
+#### `get<TOut>(path: string | string[], zSchema: z.ZodSchema<TOut>): TOut`
+
+Retrieves and validates configuration value at the specified path.
+
+**Parameters:**
+- `path: string | string[]` - Path to configuration value (dot notation or array)
+- `zSchema: z.ZodSchema<TOut>` - Zod schema for validation and type inference
+
+**Returns:** Validated value of type `TOut`
+
+**Throws:** `ZodError` if validation fails
+
+**Example:**
+```typescript
+const apiUrl = this.#config.get('api.baseUrl', z.string().url());
+// apiUrl is typed as string and validated as URL
+
+const config = this.#config.get(
+  'database',
+  z.object({
+    host: z.string(),
+    port: z.number()
+  })
+);
+// config is typed as { host: string; port: number; }
+```
+
+#### `get(path: string | string[]): any` (Deprecated)
+
+Retrieves configuration value without validation.
+
+**Parameters:**
+- `path: string | string[]` - Path to configuration value
+
+**Returns:** Unvalidated value of type `any`
+
+**Deprecated:** Use the version with Zod schema instead
+
+**Example:**
+```typescript
+// Not recommended
+const value = this.#config.get('some.path');  // Type: any
+```
+
+## Usage Examples
+
+### Basic Configuration Access
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Config } from '@isa/core/config';
+import { z } from 'zod';
+
+@Component({
+  selector: 'app-api-client',
+  template: '...'
+})
+export class ApiClientComponent {
+  #config = inject(Config);
+
+  // Get string value
+  apiBaseUrl = this.#config.get('api.baseUrl', z.string());
+
+  // Get number value
+  timeout = this.#config.get('api.timeout', z.number());
+
+  // Get boolean value
+  debugMode = this.#config.get('debug', z.boolean());
+
+  ngOnInit() {
+    console.log(`Connecting to ${this.apiBaseUrl}`);
+    console.log(`Timeout: ${this.timeout}ms`);
+    console.log(`Debug: ${this.debugMode}`);
+  }
+}
+```
+
+### Complex Object Configuration
+
+```typescript
+import { Component, inject, OnInit } from '@angular/core';
+import { Config } from '@isa/core/config';
+import { z } from 'zod';
+
+// Define schema
+const DatabaseConfigSchema = z.object({
+  host: z.string().min(1),
+  port: z.number().int().positive(),
+  database: z.string().min(1),
+  username: z.string(),
+  password: z.string(),
+  ssl: z.boolean().default(false),
+  poolSize: z.number().int().positive().default(10)
+});
+
+type DatabaseConfig = z.infer<typeof DatabaseConfigSchema>;
+
+@Component({
+  selector: 'app-database',
+  template: '...'
+})
+export class DatabaseComponent implements OnInit {
+  #config = inject(Config);
+
+  dbConfig!: DatabaseConfig;
+
+  ngOnInit() {
+    this.dbConfig = this.#config.get('database', DatabaseConfigSchema);
+
+    console.log(`Connecting to ${this.dbConfig.host}:${this.dbConfig.port}`);
+    console.log(`Database: ${this.dbConfig.database}`);
+    console.log(`SSL: ${this.dbConfig.ssl}`);
+  }
+}
+```
+
+### Array Configuration
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Config } from '@isa/core/config';
+import { z } from 'zod';
+
+@Component({
+  selector: 'app-cors-config',
+  template: '...'
+})
+export class CorsConfigComponent {
+  #config = inject(Config);
+
+  // Array of strings
+  allowedOrigins = this.#config.get(
+    'cors.allowedOrigins',
+    z.array(z.string().url())
+  );
+
+  // Array of numbers
+  allowedPorts = this.#config.get(
+    'security.allowedPorts',
+    z.array(z.number().int().positive())
+  );
+
+  isOriginAllowed(origin: string): boolean {
+    return this.allowedOrigins.includes(origin);
+  }
+}
+```
+
+### Optional and Default Values
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Config } from '@isa/core/config';
+import { z } from 'zod';
+
+@Component({
+  selector: 'app-features',
+  template: '...'
+})
+export class FeaturesComponent {
+  #config = inject(Config);
+
+  // Optional value (may be undefined)
+  betaFeature = this.#config.get(
+    'features.beta.enabled',
+    z.boolean().optional()
+  );
+
+  // Value with default
+  maxUploadSize = this.#config.get(
+    'upload.maxSize',
+    z.number().default(10485760)  // 10MB default
+  );
+
+  // Optional object
+  experimentalConfig = this.#config.get(
+    'experimental',
+    z.object({
+      enabled: z.boolean(),
+      features: z.array(z.string())
+    }).optional()
+  );
+
+  isBetaEnabled(): boolean {
+    return this.betaFeature ?? false;
+  }
+}
+```
+
+### Environment-Specific Configuration
+
+```typescript
+// environment.ts
+export const environment = {
+  production: false,
+  api: {
+    baseUrl: 'http://localhost:3000',
+    timeout: 30000
+  },
+  features: {
+    analytics: false,
+    debugPanel: true
+  }
+};
+
+// environment.prod.ts
+export const environment = {
+  production: true,
+  api: {
+    baseUrl: 'https://api.production.com',
+    timeout: 10000
+  },
+  features: {
+    analytics: true,
+    debugPanel: false
+  }
+};
+
+// app.config.ts
+import { ApplicationConfig } from '@angular/core';
+import { CONFIG_DATA } from '@isa/core/config';
+import { environment } from './environments/environment';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    {
+      provide: CONFIG_DATA,
+      useValue: environment
+    }
+  ]
+};
+
+// api.service.ts
+import { Injectable, inject } from '@angular/core';
+import { Config } from '@isa/core/config';
+import { z } from 'zod';
+
+@Injectable({ providedIn: 'root' })
+export class ApiService {
+  #config = inject(Config);
+
+  #apiConfig = this.#config.get(
+    'api',
+    z.object({
+      baseUrl: z.string().url(),
+      timeout: z.number()
+    })
+  );
+
+  get baseUrl(): string {
+    return this.#apiConfig.baseUrl;
+  }
+
+  get timeout(): number {
+    return this.#apiConfig.timeout;
+  }
+}
+```
+
+### Feature Flag Configuration
+
+```typescript
+import { Injectable, inject } from '@angular/core';
+import { Config } from '@isa/core/config';
+import { z } from 'zod';
+
+const FeatureFlagsSchema = z.object({
+  newDashboard: z.boolean().default(false),
+  advancedSearch: z.boolean().default(false),
+  exportToPdf: z.boolean().default(true),
+  darkMode: z.boolean().default(false),
+  experimentalFeatures: z.array(z.string()).default([])
+});
+
+type FeatureFlags = z.infer<typeof FeatureFlagsSchema>;
+
+@Injectable({ providedIn: 'root' })
+export class FeatureFlagService {
+  #config = inject(Config);
+
+  #flags: FeatureFlags = this.#config.get('features', FeatureFlagsSchema);
+
+  isEnabled(feature: keyof Omit<FeatureFlags, 'experimentalFeatures'>): boolean {
+    return this.#flags[feature];
+  }
+
+  isExperimentalEnabled(feature: string): boolean {
+    return this.#flags.experimentalFeatures.includes(feature);
+  }
+}
+
+// Usage in component
+@Component({
+  selector: 'app-dashboard',
+  template: `
+    @if (featureFlags.isEnabled('newDashboard')) {
+      <app-new-dashboard />
+    } @else {
+      <app-legacy-dashboard />
+    }
+  `
+})
+export class DashboardComponent {
+  featureFlags = inject(FeatureFlagService);
+}
+```
+
+### Validation with Custom Error Handling
+
+```typescript
+import { Component, inject, OnInit } from '@angular/core';
+import { Config } from '@isa/core/config';
+import { z, ZodError } from 'zod';
+
+@Component({
+  selector: 'app-config-validator',
+  template: '...'
+})
+export class ConfigValidatorComponent implements OnInit {
+  #config = inject(Config);
+
+  ngOnInit() {
+    try {
+      const apiConfig = this.#config.get(
+        'api',
+        z.object({
+          baseUrl: z.string().url('Invalid API URL'),
+          timeout: z.number().positive('Timeout must be positive'),
+          retries: z.number().int().min(0, 'Retries cannot be negative')
+        })
+      );
+
+      console.log('Configuration valid:', apiConfig);
+    } catch (error) {
+      if (error instanceof ZodError) {
+        console.error('Configuration validation failed:');
+        error.errors.forEach(err => {
+          console.error(`  - ${err.path.join('.')}: ${err.message}`);
+        });
+
+        // Fallback to defaults
+        this.useFallbackConfig();
+      }
+    }
+  }
+
+  private useFallbackConfig() {
+    console.warn('Using fallback configuration');
+    // Use hardcoded defaults
+  }
+}
+```
+
+## Configuration Patterns
+
+### Typed Configuration Service
+
+Create a dedicated service with typed configuration access:
+
+```typescript
+import { Injectable, inject } from '@angular/core';
+import { Config } from '@isa/core/config';
+import { z } from 'zod';
+
+// Define all schemas
+const ApiConfigSchema = z.object({
+  baseUrl: z.string().url(),
+  timeout: z.number().positive(),
+  retries: z.number().int().min(0)
+});
+
+const AuthConfigSchema = z.object({
+  clientId: z.string(),
+  redirectUri: z.string().url(),
+  scopes: z.array(z.string())
+});
+
+const AppConfigSchema = z.object({
+  name: z.string(),
+  version: z.string(),
+  buildNumber: z.string()
+});
+
+// Type exports
+export type ApiConfig = z.infer<typeof ApiConfigSchema>;
+export type AuthConfig = z.infer<typeof AuthConfigSchema>;
+export type AppConfig = z.infer<typeof AppConfigSchema>;
+
+@Injectable({ providedIn: 'root' })
+export class AppConfigService {
+  #config = inject(Config);
+
+  // Lazy-loaded, cached configuration
+  #apiConfig?: ApiConfig;
+  #authConfig?: AuthConfig;
+  #appConfig?: AppConfig;
+
+  get api(): ApiConfig {
+    if (!this.#apiConfig) {
+      this.#apiConfig = this.#config.get('api', ApiConfigSchema);
+    }
+    return this.#apiConfig;
+  }
+
+  get auth(): AuthConfig {
+    if (!this.#authConfig) {
+      this.#authConfig = this.#config.get('auth', AuthConfigSchema);
+    }
+    return this.#authConfig;
+  }
+
+  get app(): AppConfig {
+    if (!this.#appConfig) {
+      this.#appConfig = this.#config.get('app', AppConfigSchema);
+    }
+    return this.#appConfig;
+  }
+}
+
+// Usage
+@Component({
+  selector: 'app-root',
+  template: '...'
+})
+export class AppComponent {
+  appConfig = inject(AppConfigService);
+
+  ngOnInit() {
+    console.log(`API: ${this.appConfig.api.baseUrl}`);
+    console.log(`Auth: ${this.appConfig.auth.clientId}`);
+    console.log(`Version: ${this.appConfig.app.version}`);
+  }
+}
+```
+
+### Dynamic Configuration Loading
+
+Load configuration from external source at startup:
+
+```typescript
+import { APP_INITIALIZER, ApplicationConfig } from '@angular/core';
+import { HttpClient } from '@angular/common/http';
+import { CONFIG_DATA } from '@isa/core/config';
+import { inject } from '@angular/core';
+import { lastValueFrom } from 'rxjs';
+
+function loadConfiguration() {
+  const http = inject(HttpClient);
+
+  return async () => {
+    try {
+      const config = await lastValueFrom(
+        http.get<JsonValue>('/assets/config.json')
+      );
+      return config;
+    } catch (error) {
+      console.error('Failed to load configuration', error);
+      // Return fallback configuration
+      return {
+        api: { baseUrl: 'http://localhost:3000' }
+      };
+    }
+  };
+}
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    {
+      provide: APP_INITIALIZER,
+      useFactory: () => {
+        const loadConfig = loadConfiguration();
+        return () => loadConfig().then(config => {
+          // Config will be available via CONFIG_DATA
+        });
+      },
+      multi: true
+    },
+    {
+      provide: CONFIG_DATA,
+      useFactory: loadConfiguration()
+    }
+  ]
+};
+```
+
+### Multi-Environment Configuration
+
+Structured configuration for multiple environments:
+
+```typescript
+// config/base.config.ts
+export const baseConfig = {
+  app: {
+    name: 'ISA Frontend',
+    version: '1.0.0'
+  },
+  features: {
+    reporting: true,
+    analytics: true
+  }
+};
+
+// config/development.config.ts
+import { baseConfig } from './base.config';
+
+export const developmentConfig = {
+  ...baseConfig,
+  api: {
+    baseUrl: 'http://localhost:3000',
+    timeout: 60000
+  },
+  features: {
+    ...baseConfig.features,
+    debugPanel: true,
+    mockData: true
+  }
+};
+
+// config/production.config.ts
+import { baseConfig } from './base.config';
+
+export const productionConfig = {
+  ...baseConfig,
+  api: {
+    baseUrl: 'https://api.production.com',
+    timeout: 30000
+  },
+  features: {
+    ...baseConfig.features,
+    debugPanel: false,
+    mockData: false
+  }
+};
+
+// app.config.ts
+import { CONFIG_DATA } from '@isa/core/config';
+import { developmentConfig } from './config/development.config';
+import { productionConfig } from './config/production.config';
+import { environment } from './environments/environment';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    {
+      provide: CONFIG_DATA,
+      useValue: environment.production ? productionConfig : developmentConfig
+    }
+  ]
+};
+```
+
+## Testing
+
+The library uses **Jest** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test core-config --skip-nx-cache
+
+# Run tests with coverage
+npx nx test core-config --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test core-config --watch
+```
+
+### Testing Components with Config
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { Config, CONFIG_DATA } from '@isa/core/config';
+import { MyComponent } from './my.component';
+
+describe('MyComponent', () => {
+  const mockConfig = {
+    api: {
+      baseUrl: 'http://test.example.com',
+      timeout: 5000
+    },
+    features: {
+      enabled: true
+    }
+  };
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      providers: [
+        {
+          provide: CONFIG_DATA,
+          useValue: mockConfig
+        }
+      ]
+    });
+  });
+
+  it('should access configuration', () => {
+    const component = TestBed.createComponent(MyComponent).componentInstance;
+
+    const config = component.getApiConfig();
+    expect(config.baseUrl).toBe('http://test.example.com');
+    expect(config.timeout).toBe(5000);
+  });
+});
+```
+
+### Testing Config Service Directly
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { Config, CONFIG_DATA } from '@isa/core/config';
+import { z } from 'zod';
+
+describe('Config Service', () => {
+  let service: Config;
+
+  const testConfig = {
+    app: {
+      name: 'Test App',
+      version: '1.0.0'
+    },
+    features: {
+      enabled: ['feature1', 'feature2']
+    }
+  };
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      providers: [
+        {
+          provide: CONFIG_DATA,
+          useValue: testConfig
+        }
+      ]
+    });
+    service = TestBed.inject(Config);
+  });
+
+  it('should retrieve string value', () => {
+    const name = service.get('app.name', z.string());
+    expect(name).toBe('Test App');
+  });
+
+  it('should retrieve nested object', () => {
+    const app = service.get(
+      'app',
+      z.object({
+        name: z.string(),
+        version: z.string()
+      })
+    );
+
+    expect(app.name).toBe('Test App');
+    expect(app.version).toBe('1.0.0');
+  });
+
+  it('should retrieve array', () => {
+    const features = service.get('features.enabled', z.array(z.string()));
+    expect(features).toEqual(['feature1', 'feature2']);
+  });
+
+  it('should throw on validation failure', () => {
+    expect(() => {
+      service.get('app.version', z.number());  // version is string, not number
+    }).toThrow();
+  });
+
+  it('should handle missing path gracefully', () => {
+    const missing = service.get('nonexistent.path', z.string().optional());
+    expect(missing).toBeUndefined();
+  });
+});
+```
+
+### Example Test Suite
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach } from '@jest/globals';
+import { Config, CONFIG_DATA } from '@isa/core/config';
+import { z } from 'zod';
+
+describe('Config Service - Advanced', () => {
+  let service: Config;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      providers: [
+        {
+          provide: CONFIG_DATA,
+          useValue: {
+            database: {
+              host: 'localhost',
+              port: 5432
+            },
+            timeout: 30000
+          }
+        }
+      ]
+    });
+    service = TestBed.inject(Config);
+  });
+
+  it('should accept string path', () => {
+    const host = service.get('database.host', z.string());
+    expect(host).toBe('localhost');
+  });
+
+  it('should accept array path', () => {
+    const host = service.get(['database', 'host'], z.string());
+    expect(host).toBe('localhost');
+  });
+
+  it('should validate with schema', () => {
+    const port = service.get('database.port', z.number().int().positive());
+    expect(port).toBe(5432);
+  });
+
+  it('should apply default values', () => {
+    const retries = service.get('retries', z.number().default(3));
+    expect(retries).toBe(3);
+  });
+});
+```
+
+## Architecture Notes
+
+### Current Architecture
+
+Simple, focused architecture:
+
+```
+Components/Services
+       ↓
+  Config Service
+       ↓
+  CONFIG_DATA (Injection Token)
+       ↓
+  Application Configuration Object
+```
+
+### Design Principles
+
+#### 1. Single Responsibility
+
+The Config service has one job: retrieve configuration values by path.
+
+**Benefits:**
+- Easy to understand
+- Easy to test
+- Easy to maintain
+
+#### 2. Dependency Injection
+
+Uses Angular's DI system for configuration provisioning.
+
+**Benefits:**
+- Easy to mock in tests
+- Easy to swap implementations
+- Runtime configuration injection
+
+#### 3. Type Safety through Validation
+
+Zod schemas provide both runtime validation and compile-time types.
+
+**Benefits:**
+- Catch configuration errors early
+- Type inference for better DX
+- Self-documenting configuration
+
+### Implementation Details
+
+#### Path Resolution
+
+The service uses Angular CDK's `coerceArray` for path handling:
+
+```typescript
+import { coerceArray } from '@angular/cdk/coercion';
+
+// Handles both string and array paths
+const path = coerceArray('database.host');  // ['database', 'host']
+const path2 = coerceArray(['database', 'host']);  // ['database', 'host']
+```
+
+#### Nested Property Access
+
+Iterative navigation through object properties:
+
+```typescript
+let result: JsonValue = this.#config;
+
+for (const p of path) {
+  if (typeof result === 'object' && result !== null && !Array.isArray(result)) {
+    result = result[p];
+  } else {
+    break;  // Can't navigate further
+  }
+
+  if (result === null || result === undefined) {
+    break;  // Path doesn't exist
+  }
+}
+```
+
+**Behavior:**
+- Stops at first non-object or null/undefined
+- Returns last valid value found
+- Returns undefined if path doesn't exist
+
+### Performance Considerations
+
+1. **No Caching** - Service doesn't cache values (intentional for simplicity)
+2. **Path Parsing** - String paths split on every access (minimal overhead)
+3. **Validation Cost** - Zod validation runs on every access (consider caching in consuming services)
+
+**Optimization Pattern:**
+```typescript
+@Injectable({ providedIn: 'root' })
+export class ApiService {
+  #config = inject(Config);
+
+  // Cache validated config (runs once)
+  #apiConfig = this.#config.get('api', ApiConfigSchema);
+
+  // Access cached value (no repeated validation)
+  get baseUrl(): string {
+    return this.#apiConfig.baseUrl;
+  }
+}
+```
+
+### Known Limitations
+
+#### 1. Shallow JSON Structure Only
+
+**Current State:**
+- Only supports JSON-compatible data
+- No support for functions, classes, symbols
+- Arrays can only contain primitives
+
+**Reason:** Configuration should be serializable (JSON files, API responses)
+
+**Workaround:** Transform configuration after loading if complex types needed
+
+#### 2. No Deep Array Access
+
+**Current State:**
+```typescript
+// This works
+const features = config.get('features.enabled', z.array(z.string()));
+
+// This doesn't work (can't index into arrays by path)
+const firstFeature = config.get('features.enabled[0]', z.string());
+```
+
+**Workaround:** Retrieve array first, then index in application code
+
+#### 3. No Path Existence Check
+
+**Current State:**
+- No dedicated method to check if path exists
+- Must attempt retrieval and handle undefined
+
+**Workaround:** Use optional schemas
+```typescript
+const value = config.get('maybe.exists', z.string().optional());
+if (value !== undefined) {
+  // Path exists
+}
+```
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Path Validation** - Compile-time path checking with TypeScript
+2. **Configuration Watching** - React to configuration changes
+3. **Configuration Merging** - Merge multiple configuration sources
+4. **Environment Validation** - Validate entire config object at startup
+5. **Path Autocomplete** - IDE autocomplete for configuration paths
+6. **Nested Array Access** - Support array indexing in paths
+7. **Configuration Schema** - Define complete application configuration schema
+
+### Migration from Untyped Access
+
+Gradual migration path:
+
+```typescript
+// Old (untyped)
+const url = this.#config.get('api.baseUrl');  // Type: any
+
+// New (typed)
+const url = this.#config.get('api.baseUrl', z.string());  // Type: string
+```
+
+**Migration Strategy:**
+1. Start with critical paths (API URLs, database config)
+2. Add schemas incrementally
+3. Use optional schemas for uncertain paths
+4. Eventually remove deprecated untyped access
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework
+- `@angular/cdk/coercion` - Array coercion utilities
+- `zod` - Schema validation
+
+### Path Alias
+
+Import from: `@isa/core/config`
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/core/tabs/README.md b/libs/core/tabs/README.md
index efa398cc2..7d37a8bb0 100644
--- a/libs/core/tabs/README.md
+++ b/libs/core/tabs/README.md
@@ -1,7 +1,1542 @@
-# core-tabs
+# @isa/core/tabs
 
-This library was generated with [Nx](https://nx.dev).
+A sophisticated tab management system for Angular applications providing browser-like navigation with intelligent history management, persistence, and configurable pruning strategies.
 
-## Running unit tests
+## Overview
 
-Run `nx test core-tabs` to execute the unit tests.
+The Core Tabs library provides a comprehensive solution for managing multiple tabs with navigation history in Angular applications. Built on NgRx Signals, it offers persistent state management, intelligent history pruning, and seamless integration with Angular Router. The system supports unlimited tabs with configurable history limits, automatic browser navigation synchronization, and flexible metadata storage for domain-specific extensions.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [History Pruning](#history-pruning)
+- [Configuration](#configuration)
+- [Router Integration](#router-integration)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **NgRx Signals state management** - Modern functional state with reactive patterns
+- **Persistent tab storage** - Automatic state persistence with UserStorageProvider
+- **Browser navigation sync** - Automatic Router event synchronization
+- **Intelligent history pruning** - Three strategies: oldest, balanced, smart
+- **Configurable limits** - Per-tab or global history size configuration
+- **Zod validation** - Runtime schema validation for all operations
+- **Index validation** - Automatic history index integrity checking
+- **Forward/backward navigation** - Browser-style back/forward with pruning awareness
+- **Metadata system** - Flexible per-tab metadata storage
+- **Angular DevTools integration** - Debug tab state with Redux DevTools
+- **Router resolver** - Automatic tab creation from route parameters
+- **Injection helpers** - Convenient signal-based injection functions
+- **Navigate back component** - Ready-to-use back button component
+
+## Quick Start
+
+### 1. Import and Inject
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { TabService, injectTab, injectTabId } from '@isa/core/tabs';
+
+@Component({
+  selector: 'app-feature',
+  template: '...'
+})
+export class FeatureComponent {
+  // Option 1: Inject full service
+  #tabService = inject(TabService);
+
+  // Option 2: Inject current tab as signal
+  currentTab = injectTab();
+
+  // Option 3: Inject current tab ID as signal
+  currentTabId = injectTabId();
+}
+```
+
+### 2. Create and Activate a Tab
+
+```typescript
+createNewTab(): void {
+  const tab = this.#tabService.addTab({
+    name: 'Customer Details',
+    tags: ['customer', 'active'],
+    metadata: { customerId: 12345 }
+  });
+
+  this.#tabService.activateTab(tab.id);
+  console.log(`Created tab ${tab.id} at ${new Date(tab.createdAt)}`);
+}
+```
+
+### 3. Navigate to a Location
+
+```typescript
+navigateToCustomer(customerId: number): void {
+  const tabId = this.#tabService.activatedTabId();
+  if (!tabId) return;
+
+  this.#tabService.navigateToLocation(tabId, {
+    timestamp: Date.now(),
+    title: `Customer ${customerId}`,
+    url: `/customer/${customerId}`
+  });
+}
+```
+
+### 4. Navigate Back/Forward
+
+```typescript
+goBack(): void {
+  const tabId = this.#tabService.activatedTabId();
+  if (!tabId) return;
+
+  const previousLocation = this.#tabService.navigateBack(tabId);
+  if (previousLocation) {
+    this.router.navigateByUrl(previousLocation.url);
+  }
+}
+
+goForward(): void {
+  const tabId = this.#tabService.activatedTabId();
+  if (!tabId) return;
+
+  const nextLocation = this.#tabService.navigateForward(tabId);
+  if (nextLocation) {
+    this.router.navigateByUrl(nextLocation.url);
+  }
+}
+```
+
+### 5. Setup Router Integration
+
+```typescript
+import { ApplicationConfig } from '@angular/core';
+import { TabNavigationService } from '@isa/core/tabs';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    // ... other providers
+    {
+      provide: APP_INITIALIZER,
+      useFactory: (tabNav: TabNavigationService) => () => tabNav.init(),
+      deps: [TabNavigationService],
+      multi: true
+    }
+  ]
+};
+```
+
+## Core Concepts
+
+### Tab Entity Structure
+
+Each tab is stored as an NgRx entity with the following structure:
+
+```typescript
+interface Tab {
+  id: number;                           // Unique identifier
+  name: string;                         // Display name
+  createdAt: number;                    // Creation timestamp (ms)
+  activatedAt?: number;                 // Last activation timestamp
+  metadata: Record<string, unknown>;    // Flexible metadata storage
+  location: TabLocationHistory;         // Navigation history
+  tags: string[];                       // Organization tags
+}
+```
+
+### Location History
+
+Navigation history is tracked using a cursor-based system:
+
+```typescript
+interface TabLocationHistory {
+  current: number;                      // Index of current location (-1 for empty)
+  locations: TabLocation[];             // Array of visited locations
+}
+
+interface TabLocation {
+  timestamp: number;                    // Visit timestamp (ms)
+  title: string;                        // Page title
+  url: string;                          // Full URL
+}
+```
+
+**Example Navigation Flow:**
+```typescript
+// Initial state
+{ current: -1, locations: [] }
+
+// After navigating to /home
+{ current: 0, locations: [{ timestamp: ..., title: 'Home', url: '/home' }] }
+
+// After navigating to /products
+{
+  current: 1,
+  locations: [
+    { timestamp: ..., title: 'Home', url: '/home' },
+    { timestamp: ..., title: 'Products', url: '/products' }
+  ]
+}
+
+// After navigating back
+{ current: 0, locations: [...] }  // Points back to /home
+```
+
+### Tab Metadata
+
+Metadata provides flexible per-tab storage for domain-specific data:
+
+```typescript
+// Store customer context
+this.#tabService.patchTabMetadata(tabId, {
+  customerId: 12345,
+  customerName: 'John Doe',
+  viewMode: 'details'
+});
+
+// Retrieve typed metadata
+import { getMetadataHelper } from '@isa/core/tabs';
+
+const customerId = getMetadataHelper(
+  tabId,
+  'customerId',
+  z.number(),
+  this.#tabService.entityMap()
+);
+```
+
+**History Configuration Overrides:**
+```typescript
+// Override global history limits per tab
+this.#tabService.patchTabMetadata(tabId, {
+  maxHistorySize: 25,        // Override global limit
+  maxForwardHistory: 5       // Custom forward history depth
+});
+```
+
+### Tab ID Generation
+
+Tab IDs are automatically generated using timestamp-based generation:
+
+```typescript
+// Automatic ID generation
+const tab = this.#tabService.addTab({
+  name: 'New Tab'
+  // ID automatically generated: Date.now()
+});
+
+// Manual ID specification
+const tab = this.#tabService.addTab({
+  id: 42,
+  name: 'Fixed ID Tab'
+});
+```
+
+## API Reference
+
+### TabService
+
+NgRx SignalStore providing complete tab management functionality.
+
+#### State Properties
+
+##### `entities(): Tab[]`
+Returns array of all tabs in the store.
+
+**Example:**
+```typescript
+const allTabs = this.#tabService.entities();
+console.log(`Total tabs: ${allTabs.length}`);
+```
+
+##### `entityMap(): { [id: number]: Tab }`
+Returns dictionary mapping tab IDs to tab objects.
+
+**Example:**
+```typescript
+const tabMap = this.#tabService.entityMap();
+const tab42 = tabMap[42];
+```
+
+##### `activatedTabId(): number | null`
+Returns ID of currently activated tab, or null.
+
+**Example:**
+```typescript
+const activeId = this.#tabService.activatedTabId();
+if (activeId !== null) {
+  console.log(`Active tab: ${activeId}`);
+}
+```
+
+##### `activatedTab(): Tab | null`
+Computed signal returning currently activated tab entity.
+
+**Example:**
+```typescript
+const activeTab = this.#tabService.activatedTab();
+if (activeTab) {
+  console.log(`Active: ${activeTab.name}`);
+}
+```
+
+#### Tab Management Methods
+
+##### `addTab(params): Tab`
+
+Creates and adds a new tab to the store.
+
+**Parameters:**
+- `params: AddTabInput` - Tab creation parameters (validated with Zod)
+  - `name?: string` - Display name (default: 'Neuer Vorgang')
+  - `tags?: string[]` - Initial tags (default: [])
+  - `metadata?: Record<string, unknown>` - Initial metadata (default: {})
+  - `id?: number` - Optional ID (auto-generated if omitted)
+  - `activatedAt?: number` - Optional activation timestamp
+
+**Returns:** Created Tab entity with generated ID and timestamps
+
+**Example:**
+```typescript
+const tab = this.#tabService.addTab({
+  name: 'Customer Order #1234',
+  tags: ['order', 'customer'],
+  metadata: { orderId: 1234, status: 'pending' }
+});
+
+console.log(`Created tab ${tab.id}`);
+```
+
+##### `activateTab(id: number): void`
+
+Activates a tab by ID and updates its activation timestamp.
+
+**Parameters:**
+- `id: number` - Tab ID to activate
+
+**Side Effects:**
+- Updates `activatedTabId` state
+- Sets tab's `activatedAt` to current timestamp
+
+**Example:**
+```typescript
+this.#tabService.activateTab(42);
+```
+
+##### `patchTab(id: number, changes: PatchTabInput): void`
+
+Partially updates a tab's properties.
+
+**Parameters:**
+- `id: number` - Tab ID to update
+- `changes: PatchTabInput` - Partial tab updates
+  - `name?: string` - Updated display name
+  - `tags?: string[]` - Updated tags array
+  - `metadata?: Record<string, unknown>` - Metadata to merge
+  - `location?: TabLocationHistory` - Updated location history
+
+**Example:**
+```typescript
+this.#tabService.patchTab(42, {
+  name: 'Updated Name',
+  tags: ['new-tag'],
+  metadata: { additionalField: 'value' }
+});
+```
+
+##### `patchTabMetadata(id: number, metadata: Record<string, unknown>): void`
+
+Updates tab metadata by merging with existing metadata.
+
+**Parameters:**
+- `id: number` - Tab ID to update
+- `metadata: Record<string, unknown>` - Metadata to merge
+
+**Example:**
+```typescript
+// Existing metadata: { customerId: 123 }
+this.#tabService.patchTabMetadata(42, {
+  orderCount: 5
+});
+// Result: { customerId: 123, orderCount: 5 }
+```
+
+##### `removeTab(id: number): void`
+
+Removes a tab from the store.
+
+**Parameters:**
+- `id: number` - Tab ID to remove
+
+**Example:**
+```typescript
+this.#tabService.removeTab(42);
+```
+
+#### Navigation Methods
+
+##### `navigateToLocation(id: number, location: TabLocationInput): TabLocation | null`
+
+Navigates to a new location in tab history with intelligent pruning.
+
+**Parameters:**
+- `id: number` - Tab ID to navigate
+- `location: TabLocationInput` - Location to add
+  - `timestamp: number` - Visit timestamp (ms)
+  - `title: string` - Page title
+  - `url: string` - Full URL
+
+**Returns:** Validated TabLocation, or null if tab not found
+
+**Behavior:**
+1. Prunes forward history based on `maxForwardHistory`
+2. Adds new location after current position
+3. Applies history size pruning if needed
+4. Validates and corrects history index
+
+**Example:**
+```typescript
+this.#tabService.navigateToLocation(42, {
+  timestamp: Date.now(),
+  title: 'Product Details',
+  url: '/products/123'
+});
+```
+
+##### `navigateBack(id: number): TabLocation | null`
+
+Navigates backward in tab history.
+
+**Parameters:**
+- `id: number` - Tab ID to navigate
+
+**Returns:** Previous location, or null if at start or tab not found
+
+**Example:**
+```typescript
+const previousLocation = this.#tabService.navigateBack(42);
+if (previousLocation) {
+  this.router.navigateByUrl(previousLocation.url);
+}
+```
+
+##### `navigateForward(id: number): TabLocation | null`
+
+Navigates forward in tab history.
+
+**Parameters:**
+- `id: number` - Tab ID to navigate
+
+**Returns:** Next location, or null if at end or tab not found
+
+**Example:**
+```typescript
+const nextLocation = this.#tabService.navigateForward(42);
+if (nextLocation) {
+  this.router.navigateByUrl(nextLocation.url);
+}
+```
+
+##### `getCurrentLocation(id: number): TabLocation | null`
+
+Gets current location with automatic index validation.
+
+**Parameters:**
+- `id: number` - Tab ID to query
+
+**Returns:** Current location, or null if none or invalid
+
+**Side Effects:**
+- Automatically corrects invalid history indices
+- Logs warnings if index correction occurs (when enabled)
+
+**Example:**
+```typescript
+const currentLoc = this.#tabService.getCurrentLocation(42);
+if (currentLoc) {
+  console.log(`Current page: ${currentLoc.title}`);
+}
+```
+
+##### `updateCurrentLocation(id: number, updates: Partial<TabLocation>): TabLocation | null`
+
+Updates the current location in-place.
+
+**Parameters:**
+- `id: number` - Tab ID to update
+- `updates: Partial<TabLocation>` - Properties to update
+
+**Returns:** Updated location, or null if invalid
+
+**Example:**
+```typescript
+// Update current location's title
+this.#tabService.updateCurrentLocation(42, {
+  title: 'Updated Title'
+});
+```
+
+##### `clearLocationHistory(id: number): void`
+
+Clears all navigation history for a tab.
+
+**Parameters:**
+- `id: number` - Tab ID to clear
+
+**Example:**
+```typescript
+this.#tabService.clearLocationHistory(42);
+// Result: { current: -1, locations: [] }
+```
+
+### TabNavigationService
+
+Service that automatically synchronizes Angular Router navigation with tab history.
+
+#### `init(): void`
+
+Initializes automatic navigation synchronization.
+
+**Behavior:**
+- Subscribes to Router NavigationEnd events
+- Updates tab location history on each navigation
+- Handles browser back/forward with pruning awareness
+- Respects URL blacklist configuration
+
+**Usage:**
+```typescript
+// In app config
+{
+  provide: APP_INITIALIZER,
+  useFactory: (tabNav: TabNavigationService) => () => tabNav.init(),
+  deps: [TabNavigationService],
+  multi: true
+}
+```
+
+#### `syncCurrentRoute(): void`
+
+Manually syncs current route to active tab's history.
+
+**Use Cases:**
+- Initial page loads
+- New tab creation
+- Manual synchronization after route changes
+- Recovery scenarios
+
+**Example:**
+```typescript
+// After creating a new tab
+const tab = this.#tabService.addTab({ name: 'New Tab' });
+this.#tabService.activateTab(tab.id);
+this.#tabNavigationService.syncCurrentRoute();
+```
+
+### Helper Functions
+
+#### `injectTab(): Signal<Tab | null>`
+
+Injects current activated tab as a signal.
+
+**Returns:** Signal emitting active tab or null
+
+**Example:**
+```typescript
+export class MyComponent {
+  currentTab = injectTab();
+
+  ngOnInit() {
+    effect(() => {
+      const tab = this.currentTab();
+      console.log(`Active tab: ${tab?.name}`);
+    });
+  }
+}
+```
+
+#### `injectTabId(): Signal<number | null>`
+
+Injects current tab ID as a signal.
+
+**Returns:** Signal emitting active tab ID or null
+
+**Example:**
+```typescript
+export class MyComponent {
+  currentTabId = injectTabId();
+
+  isTabActive = computed(() => this.currentTabId() !== null);
+}
+```
+
+#### `getTabHelper(tabId: number, entities: Record<number, Tab>): Tab | undefined`
+
+Retrieves a tab from entity map.
+
+**Parameters:**
+- `tabId: number` - Tab ID to retrieve
+- `entities: Record<number, Tab>` - Entity map from TabService
+
+**Returns:** Tab entity or undefined
+
+**Example:**
+```typescript
+const tab = getTabHelper(42, this.#tabService.entityMap());
+```
+
+#### `getMetadataHelper<T>(tabId, key, schema, entities): T | undefined`
+
+Retrieves typed metadata value with Zod validation.
+
+**Parameters:**
+- `tabId: number` - Tab ID to query
+- `key: string` - Metadata key to retrieve
+- `schema: ZodSchema<T>` - Zod schema for validation
+- `entities: EntityMap<Tab>` - Entity map from TabService
+
+**Returns:** Validated metadata value or undefined
+
+**Example:**
+```typescript
+import { z } from 'zod';
+
+const customerId = getMetadataHelper(
+  42,
+  'customerId',
+  z.number(),
+  this.#tabService.entityMap()
+);
+
+if (customerId !== undefined) {
+  console.log(`Customer ID: ${customerId}`);
+}
+```
+
+### Router Resolver
+
+#### `tabResolverFn: ResolveFn<Tab>`
+
+Angular Router resolver that ensures tab exists before route activation.
+
+**Behavior:**
+- Extracts tabId from route parameter
+- Creates tab if it doesn't exist
+- Activates the tab
+- Returns tab entity for route data
+
+**Route Configuration:**
+```typescript
+import { Routes } from '@angular/router';
+import { tabResolverFn } from '@isa/core/tabs';
+
+export const routes: Routes = [
+  {
+    path: ':tabId/customer/:customerId',
+    component: CustomerComponent,
+    resolve: { tab: tabResolverFn }
+  }
+];
+```
+
+**Component Usage:**
+```typescript
+import { Component } from '@angular/core';
+import { ActivatedRoute } from '@angular/router';
+
+@Component({
+  selector: 'app-customer',
+  template: '...'
+})
+export class CustomerComponent {
+  constructor(private route: ActivatedRoute) {
+    const tab = this.route.snapshot.data['tab'];
+    console.log(`Resolved tab: ${tab.name}`);
+  }
+}
+```
+
+### NavigateBackButtonComponent
+
+Ready-to-use back button component with automatic state management.
+
+**Selector:** `tabs-navigate-back-button`
+
+**Features:**
+- Automatically disables when no back history
+- Uses current tab from TabService
+- Integrates with Angular Router
+- E2E testable with data-what attribute
+
+**Usage:**
+```typescript
+import { NavigateBackButtonComponent } from '@isa/core/tabs';
+
+@Component({
+  selector: 'app-feature',
+  imports: [NavigateBackButtonComponent],
+  template: `
+    <tabs-navigate-back-button />
+  `
+})
+export class FeatureComponent {}
+```
+
+## Usage Examples
+
+### Basic Tab Creation and Navigation
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { TabService } from '@isa/core/tabs';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-customer-search',
+  template: '...'
+})
+export class CustomerSearchComponent {
+  #tabService = inject(TabService);
+  #router = inject(Router);
+
+  openCustomerInNewTab(customerId: number): void {
+    // Create new tab with customer context
+    const tab = this.#tabService.addTab({
+      name: `Customer ${customerId}`,
+      tags: ['customer'],
+      metadata: { customerId }
+    });
+
+    // Activate the new tab
+    this.#tabService.activateTab(tab.id);
+
+    // Navigate to customer details
+    this.#router.navigate([tab.id, 'customer', customerId]);
+  }
+}
+```
+
+### Working with Tab Metadata
+
+```typescript
+import { Component, inject, OnInit } from '@angular/core';
+import { TabService, injectTabId, getMetadataHelper } from '@isa/core/tabs';
+import { z } from 'zod';
+
+const CustomerMetadataSchema = z.object({
+  customerId: z.number(),
+  customerName: z.string().optional(),
+  viewMode: z.enum(['details', 'orders', 'history']).default('details')
+});
+
+type CustomerMetadata = z.infer<typeof CustomerMetadataSchema>;
+
+@Component({
+  selector: 'app-customer-details',
+  template: '...'
+})
+export class CustomerDetailsComponent implements OnInit {
+  #tabService = inject(TabService);
+  tabId = injectTabId();
+
+  ngOnInit() {
+    const id = this.tabId();
+    if (!id) return;
+
+    // Set initial metadata
+    this.#tabService.patchTabMetadata(id, {
+      customerId: 12345,
+      customerName: 'John Doe',
+      viewMode: 'details'
+    });
+  }
+
+  getCustomerMetadata(): CustomerMetadata | undefined {
+    const id = this.tabId();
+    if (!id) return undefined;
+
+    return getMetadataHelper(
+      id,
+      'customerMetadata',
+      CustomerMetadataSchema,
+      this.#tabService.entityMap()
+    );
+  }
+
+  switchViewMode(mode: 'details' | 'orders' | 'history'): void {
+    const id = this.tabId();
+    if (!id) return;
+
+    this.#tabService.patchTabMetadata(id, { viewMode: mode });
+  }
+}
+```
+
+### Custom History Configuration
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { TabService } from '@isa/core/tabs';
+
+@Component({
+  selector: 'app-wizard',
+  template: '...'
+})
+export class WizardComponent {
+  #tabService = inject(TabService);
+
+  createWizardTab(): void {
+    const tab = this.#tabService.addTab({
+      name: 'Order Wizard',
+      tags: ['wizard'],
+      metadata: {
+        // Override global history limits for wizard
+        maxHistorySize: 10,      // Keep only last 10 steps
+        maxForwardHistory: 0     // Disable forward navigation (wizard-like)
+      }
+    });
+
+    this.#tabService.activateTab(tab.id);
+  }
+
+  // Forward navigation disabled by maxForwardHistory: 0
+  // User must complete wizard steps linearly
+}
+```
+
+### Browser-Style Navigation
+
+```typescript
+import { Component, inject, computed } from '@angular/core';
+import { TabService } from '@isa/core/tabs';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-navigation-controls',
+  template: `
+    <button
+      [disabled]="!canGoBack()"
+      (click)="goBack()"
+      data-what="back-button">
+      Back
+    </button>
+    <button
+      [disabled]="!canGoForward()"
+      (click)="goForward()"
+      data-what="forward-button">
+      Forward
+    </button>
+  `
+})
+export class NavigationControlsComponent {
+  #tabService = inject(TabService);
+  #router = inject(Router);
+
+  canGoBack = computed(() => {
+    const tabId = this.#tabService.activatedTabId();
+    if (!tabId) return false;
+
+    const tab = this.#tabService.entityMap()[tabId];
+    return tab ? tab.location.current > 0 : false;
+  });
+
+  canGoForward = computed(() => {
+    const tabId = this.#tabService.activatedTabId();
+    if (!tabId) return false;
+
+    const tab = this.#tabService.entityMap()[tabId];
+    if (!tab) return false;
+
+    return tab.location.current < tab.location.locations.length - 1;
+  });
+
+  goBack(): void {
+    const tabId = this.#tabService.activatedTabId();
+    if (!tabId) return;
+
+    const previousLocation = this.#tabService.navigateBack(tabId);
+    if (previousLocation) {
+      this.#router.navigateByUrl(previousLocation.url);
+    }
+  }
+
+  goForward(): void {
+    const tabId = this.#tabService.activatedTabId();
+    if (!tabId) return;
+
+    const nextLocation = this.#tabService.navigateForward(tabId);
+    if (nextLocation) {
+      this.#router.navigateByUrl(nextLocation.url);
+    }
+  }
+}
+```
+
+### Tab Filtering and Organization
+
+```typescript
+import { Component, inject, computed } from '@angular/core';
+import { TabService } from '@isa/core/tabs';
+
+@Component({
+  selector: 'app-tab-manager',
+  template: '...'
+})
+export class TabManagerComponent {
+  #tabService = inject(TabService);
+
+  // Filter tabs by tag
+  customerTabs = computed(() => {
+    return this.#tabService.entities().filter(tab =>
+      tab.tags.includes('customer')
+    );
+  });
+
+  orderTabs = computed(() => {
+    return this.#tabService.entities().filter(tab =>
+      tab.tags.includes('order')
+    );
+  });
+
+  // Sort tabs by last activation
+  recentTabs = computed(() => {
+    return [...this.#tabService.entities()]
+      .filter(tab => tab.activatedAt !== undefined)
+      .sort((a, b) => (b.activatedAt ?? 0) - (a.activatedAt ?? 0))
+      .slice(0, 5);
+  });
+
+  // Close all tabs with specific tag
+  closeCustomerTabs(): void {
+    this.customerTabs().forEach(tab => {
+      this.#tabService.removeTab(tab.id);
+    });
+  }
+}
+```
+
+## History Pruning
+
+### Pruning Strategies
+
+The library provides three intelligent pruning strategies to manage memory usage while preserving navigation functionality.
+
+#### 1. Oldest First Strategy
+
+Removes oldest history entries when size limit exceeded.
+
+**Use Case:** Simple applications with linear navigation
+
+**Behavior:**
+- FIFO (First In, First Out) removal
+- Preserves recent navigation
+- Maintains current position
+
+**Example:**
+```typescript
+// With locations [A, B, C, D, E], current=2 (C), maxHistorySize=3
+// Result: [C, D, E] with current=0 (still pointing to C)
+```
+
+**Configuration:**
+```typescript
+import { TAB_CONFIG, createTabConfig } from '@isa/core/tabs';
+
+{
+  provide: TAB_CONFIG,
+  useValue: createTabConfig({
+    pruningStrategy: 'oldest',
+    maxHistorySize: 50
+  })
+}
+```
+
+#### 2. Balanced Strategy (Default)
+
+Maintains balanced window around current position.
+
+**Use Case:** Most applications with forward/backward navigation
+
+**Behavior:**
+- Preserves 70% of entries before current position
+- Preserves 30% of entries after current position
+- Maintains navigation context around current location
+
+**Example:**
+```typescript
+// With current=5 in 20 locations, maxHistorySize=10
+// Keeps ~7 entries before current, current entry, ~2 entries after
+// Result preserves useful navigation context
+```
+
+**Configuration:**
+```typescript
+{
+  provide: TAB_CONFIG,
+  useValue: createTabConfig({
+    pruningStrategy: 'balanced',  // Default
+    maxHistorySize: 50
+  })
+}
+```
+
+#### 3. Smart Strategy
+
+Intelligent pruning based on recency and proximity.
+
+**Use Case:** Complex applications with varied navigation patterns
+
+**Behavior:**
+- Scores each location by recency and proximity to current
+- Recent locations (< 1 hour): 100 points base
+- Medium age (< 1 day): 60 points base
+- Old locations (> 1 day): 20 points base
+- Proximity bonus: 100 - (distance_from_current * 10)
+- Keeps highest-scoring locations
+
+**Example:**
+```typescript
+// Preserves:
+// - Recently visited pages (high recency score)
+// - Pages near current position (high proximity score)
+// - Removes old, distant entries first
+```
+
+**Configuration:**
+```typescript
+{
+  provide: TAB_CONFIG,
+  useValue: createTabConfig({
+    pruningStrategy: 'smart',
+    maxHistorySize: 50
+  })
+}
+```
+
+### Forward History Limiting
+
+Controls maximum forward history depth when adding new locations.
+
+**Purpose:** Prevents unlimited "redo" depth while maintaining reasonable navigation
+
+**Default:** 10 forward entries
+
+**Behavior:**
+```typescript
+// With current=2, maxForwardHistory=2
+// Before: [A, B, C, D, E, F]
+//               ^
+// After:  [A, B, C, D, E]
+//               ^
+// Preserved 2 forward entries (D, E), removed F
+```
+
+**Configuration:**
+```typescript
+// Global configuration
+{
+  provide: TAB_CONFIG,
+  useValue: createTabConfig({
+    maxForwardHistory: 5  // Limit forward history
+  })
+}
+
+// Per-tab override
+this.#tabService.patchTabMetadata(tabId, {
+  maxForwardHistory: 0  // Disable forward history (wizard-like)
+});
+```
+
+### Index Validation
+
+Automatic validation and correction of history indices.
+
+**Purpose:** Maintains data integrity after history modifications
+
+**Behavior:**
+- Validates indices on all navigation operations
+- Corrects invalid indices automatically
+- Logs warnings when corrections occur (configurable)
+
+**Example:**
+```typescript
+// Invalid index: current=10 with only 5 locations
+// Automatically corrected to: current=4 (last valid index)
+
+// Empty history: locations=[], current=5
+// Automatically corrected to: current=-1
+```
+
+**Configuration:**
+```typescript
+{
+  provide: TAB_CONFIG,
+  useValue: createTabConfig({
+    enableIndexValidation: true,  // Default: true
+    logPruning: true              // Log correction warnings
+  })
+}
+```
+
+## Configuration
+
+### TabConfig Interface
+
+```typescript
+interface TabConfig {
+  maxHistorySize: number;              // Max history entries (default: 50)
+  maxForwardHistory: number;           // Max forward entries (default: 10)
+  pruningStrategy: 'oldest' | 'balanced' | 'smart';  // Default: 'balanced'
+  enableIndexValidation: boolean;      // Default: true
+  logPruning: boolean;                 // Default: false
+}
+```
+
+### Global Configuration
+
+```typescript
+import { ApplicationConfig } from '@angular/core';
+import { TAB_CONFIG, createTabConfig } from '@isa/core/tabs';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    {
+      provide: TAB_CONFIG,
+      useValue: createTabConfig({
+        maxHistorySize: 100,
+        maxForwardHistory: 20,
+        pruningStrategy: 'smart',
+        enableIndexValidation: true,
+        logPruning: true
+      })
+    }
+  ]
+};
+```
+
+### Per-Tab Configuration Override
+
+```typescript
+// Override global limits for specific tab
+this.#tabService.addTab({
+  name: 'High History Tab',
+  metadata: {
+    maxHistorySize: 200,      // Override global limit
+    maxForwardHistory: 50     // Override global limit
+  }
+});
+
+// Runtime override
+this.#tabService.patchTabMetadata(tabId, {
+  maxHistorySize: 25,
+  maxForwardHistory: 5
+});
+```
+
+### Default Configuration
+
+```typescript
+const DEFAULT_TAB_CONFIG: TabConfig = {
+  maxHistorySize: 50,
+  maxForwardHistory: 10,
+  pruningStrategy: 'balanced',
+  enableIndexValidation: true,
+  logPruning: false
+};
+```
+
+## Router Integration
+
+### Automatic Navigation Synchronization
+
+The TabNavigationService automatically syncs Router events to tab history.
+
+**Setup:**
+```typescript
+import { ApplicationConfig, APP_INITIALIZER } from '@angular/core';
+import { TabNavigationService } from '@isa/core/tabs';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    {
+      provide: APP_INITIALIZER,
+      useFactory: (tabNav: TabNavigationService) => () => tabNav.init(),
+      deps: [TabNavigationService],
+      multi: true
+    }
+  ]
+};
+```
+
+**Behavior:**
+- Listens to NavigationEnd events
+- Extracts tabId from URL patterns (/:tabId/... or /kunde/:processId/...)
+- Creates location entries automatically
+- Handles browser back/forward with pruning awareness
+- Respects URL blacklist for excluded routes
+
+### URL Patterns
+
+The service recognizes two URL patterns:
+
+**Modern Pattern:**
+```typescript
+// URL: /42/customer/123
+// Extracted tabId: 42
+```
+
+**Legacy Pattern:**
+```typescript
+// URL: /kunde/42/details
+// Extracted processId (maps to tabId): 42
+```
+
+**Fallback:**
+```typescript
+// URL: /dashboard (no ID in URL)
+// Uses currently activated tab ID
+```
+
+### URL Blacklist
+
+Certain URLs are excluded from history tracking:
+
+```typescript
+export const HISTORY_BLACKLIST_URLS = ['/kunde/dashboard'];
+```
+
+### Router Resolver Integration
+
+```typescript
+import { Routes } from '@angular/router';
+import { tabResolverFn } from '@isa/core/tabs';
+
+export const routes: Routes = [
+  {
+    path: ':tabId',
+    resolve: { tab: tabResolverFn },
+    children: [
+      {
+        path: 'customer/:customerId',
+        component: CustomerComponent
+      },
+      {
+        path: 'order/:orderId',
+        component: OrderComponent
+      }
+    ]
+  }
+];
+```
+
+**Resolver Behavior:**
+1. Extracts tabId from route parameter
+2. Validates tabId is positive integer
+3. Creates tab if it doesn't exist (name: 'Neuer Vorgang')
+4. Activates the tab
+5. Returns tab entity for route data access
+
+## Testing
+
+The library uses **Jest** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test core-tabs --skip-nx-cache
+
+# Run tests with coverage
+npx nx test core-tabs --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test core-tabs --watch
+```
+
+### Test Structure
+
+The library would benefit from comprehensive unit tests covering:
+
+- **Tab creation** - Add, activate, remove operations
+- **Navigation** - Forward, backward, location management
+- **History pruning** - All three strategies with various scenarios
+- **Index validation** - Correction logic and edge cases
+- **Metadata management** - Patch, retrieve, type validation
+- **Router integration** - Navigation sync, blacklist, resolver
+- **State persistence** - Storage integration
+- **Configuration** - Global and per-tab overrides
+
+### Example Test (Recommended)
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach } from '@jest/globals';
+import { TabService } from './tab';
+
+describe('TabService', () => {
+  let service: TabService;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({});
+    service = TestBed.inject(TabService);
+  });
+
+  it('should create tab with auto-generated ID', () => {
+    const tab = service.addTab({ name: 'Test Tab' });
+
+    expect(tab.id).toBeGreaterThan(0);
+    expect(tab.name).toBe('Test Tab');
+    expect(tab.location.current).toBe(-1);
+    expect(tab.location.locations).toEqual([]);
+  });
+
+  it('should navigate to location', () => {
+    const tab = service.addTab({ name: 'Test' });
+
+    const location = service.navigateToLocation(tab.id, {
+      timestamp: Date.now(),
+      title: 'Home',
+      url: '/home'
+    });
+
+    expect(location).not.toBeNull();
+    expect(location?.url).toBe('/home');
+
+    const updatedTab = service.entityMap()[tab.id];
+    expect(updatedTab.location.current).toBe(0);
+    expect(updatedTab.location.locations).toHaveLength(1);
+  });
+
+  it('should navigate back', () => {
+    const tab = service.addTab({ name: 'Test' });
+
+    service.navigateToLocation(tab.id, {
+      timestamp: Date.now(),
+      title: 'Home',
+      url: '/home'
+    });
+
+    service.navigateToLocation(tab.id, {
+      timestamp: Date.now(),
+      title: 'Products',
+      url: '/products'
+    });
+
+    const previousLocation = service.navigateBack(tab.id);
+
+    expect(previousLocation?.url).toBe('/home');
+
+    const updatedTab = service.entityMap()[tab.id];
+    expect(updatedTab.location.current).toBe(0);
+  });
+});
+```
+
+## Architecture Notes
+
+### Current Architecture
+
+The library follows a layered architecture with NgRx Signals at its core:
+
+```
+Components/Features
+       ↓
+  Injection Helpers (injectTab, injectTabId)
+       ↓
+  TabNavigationService (Router sync)
+       ↓
+  TabService (NgRx SignalStore)
+       ↓
+├─→ TabHistoryPruner (history management)
+├─→ Storage Integration (UserStorageProvider)
+├─→ DevTools Integration (Redux DevTools)
+└─→ Zod Validation (schemas)
+```
+
+### Design Patterns
+
+#### 1. Signal Store Pattern
+
+Uses NgRx Signals with functional composition:
+
+```typescript
+signalStore(
+  withDevtools('TabService'),
+  withStorage('tabs', UserStorageProvider, { autosave: true }),
+  withState({ activatedTabId: null }),
+  withEntities<Tab>(),
+  withProps(),
+  withComputed(),
+  withMethods()
+)
+```
+
+**Benefits:**
+- Reactive state management
+- Automatic persistence
+- DevTools integration
+- Type-safe operations
+
+#### 2. Strategy Pattern (Pruning)
+
+Three interchangeable pruning strategies:
+
+```typescript
+switch (config.pruningStrategy) {
+  case 'oldest': return TabHistoryPruner.pruneOldestFirst(...);
+  case 'balanced': return TabHistoryPruner.pruneBalanced(...);
+  case 'smart': return TabHistoryPruner.pruneSmart(...);
+}
+```
+
+**Benefits:**
+- Configurable behavior
+- Easy testing
+- New strategies can be added
+
+#### 3. Injection Token Pattern
+
+Dependency injection for configuration and ID generation:
+
+```typescript
+export const TAB_CONFIG = new InjectionToken<TabConfig>('TAB_CONFIG', {
+  providedIn: 'root',
+  factory: () => DEFAULT_TAB_CONFIG
+});
+
+export const CORE_TAB_ID_GENERATOR = new InjectionToken<() => number>(
+  'CORE_TAB_ID_GENERATOR',
+  { providedIn: 'root', factory: () => generateTabId }
+);
+```
+
+**Benefits:**
+- Easy testing with mocks
+- Runtime configuration
+- No circular dependencies
+
+### State Persistence
+
+Automatic state persistence using `withStorage()`:
+
+```typescript
+withStorage('tabs', UserStorageProvider, { autosave: true })
+```
+
+**Features:**
+- Saves to user-scoped storage
+- Automatic save on state changes
+- Loads on service initialization
+- Validates loaded state with Zod
+
+**Storage Key:** `tabs` (namespace for user storage)
+
+### Index Integrity
+
+The system maintains history index integrity through:
+
+1. **Validation on read** - `getCurrentLocation()` validates indices
+2. **Validation on navigation** - Back/forward check bounds
+3. **Correction on errors** - Invalid indices auto-corrected
+4. **Logging** - Optional warnings for debugging
+
+**Example Correction:**
+```typescript
+// Corrupted state: current=10, locations.length=5
+const { index, wasInvalid } = TabHistoryPruner.validateLocationIndex(
+  locations,
+  current
+);
+// index=4 (corrected to last valid), wasInvalid=true
+```
+
+### Performance Considerations
+
+1. **Computed Signals** - `activatedTab` is computed, not stored
+2. **Immutable Updates** - Spread operators ensure immutability
+3. **Pruning Efficiency** - All strategies are O(n) or better
+4. **Index Validation** - O(1) validation, only corrects when needed
+5. **Storage Optimization** - Autosave debounced by library
+
+### Known Limitations
+
+#### 1. Tab ID Collision Risk (Low Priority)
+
+**Current State:**
+- Uses `Date.now()` for ID generation
+- Collision possible with rapid tab creation
+
+**Proposed Solution:**
+- Add sequence counter: `Date.now() + (counter++)`
+- Or use UUID/nanoid for guaranteed uniqueness
+
+**Impact:** Low risk in practice, rapid creation uncommon
+
+#### 2. Storage Size Limits (Medium Priority)
+
+**Current State:**
+- No limit on number of tabs
+- Storage could grow unbounded
+
+**Proposed Solutions:**
+- Maximum tab limit (configurable)
+- Automatic cleanup of old inactive tabs
+- Storage quota monitoring
+
+**Impact:** Medium risk for long-running sessions
+
+#### 3. URL Blacklist Not Configurable (Low Priority)
+
+**Current State:**
+- Hardcoded blacklist in constants
+- Cannot customize at runtime
+
+**Proposed Solution:**
+- Injection token for blacklist
+- Merge with default blacklist
+
+**Impact:** Low, blacklist rarely needs customization
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Tab Groups** - Organize tabs into collapsible groups
+2. **Tab Pinning** - Pin important tabs to prevent closure
+3. **Tab Duplication** - Clone existing tabs with history
+4. **History Export** - Export/import tab state for debugging
+5. **Analytics** - Track tab usage patterns
+6. **Lazy History** - Only load history when needed
+7. **Tab Sorting** - Custom sort orders (recent, alphabetical, manual)
+8. **Search** - Search across tab history locations
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework
+- `@angular/router` - Router integration
+- `@angular/platform-browser` - Title service
+- `@ngrx/signals` - State management
+- `@ngrx/signals/entities` - Entity management
+- `@angular-architects/ngrx-toolkit` - DevTools integration
+- `@isa/core/storage` - Storage providers
+- `@isa/core/logging` - Logging service
+- `@isa/ui/buttons` - Button component (for NavigateBackButtonComponent)
+- `@isa/icons` - Icon library (for NavigateBackButtonComponent)
+- `@ng-icons/core` - Icon framework (for NavigateBackButtonComponent)
+- `@angular/cdk/coercion` - Array coercion utilities
+- `zod` - Schema validation
+
+### Path Alias
+
+Import from: `@isa/core/tabs`
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/crm/data-access/README.md b/libs/crm/data-access/README.md
index 9791bf9e3..b236196e1 100644
--- a/libs/crm/data-access/README.md
+++ b/libs/crm/data-access/README.md
@@ -1,7 +1,1808 @@
-# crm-data-access
+# @isa/crm/data-access
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive Customer Relationship Management (CRM) data access library for Angular applications providing customer, shipping address, payer, and bonus card management with reactive data loading using Angular resources.
 
-## Running unit tests
+## Overview
 
-Run `nx test crm-data-access` to execute the unit tests.
+The CRM Data Access library provides a unified interface for managing customer data, shipping addresses, payers, bonus cards, and country information. It integrates with the generated CRM API client and provides intelligent data loading through Angular resources, tab-based state management, Zod schema validation, and type-safe transformations. The library follows modern Angular patterns with signals, resources, and dependency injection.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Resource Pattern](#resource-pattern)
+- [Tab Metadata Management](#tab-metadata-management)
+- [Validation with Zod](#validation-with-zod)
+- [Error Handling](#error-handling)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Customer management** - Fetch customer data with configurable eager loading
+- **Shipping address operations** - Retrieve customer shipping addresses with pagination
+- **Bonus card support** - Manage customer bonus cards with primary card selection
+- **Payer information** - Handle assigned payers and payment settings
+- **Country data** - Cached country information retrieval
+- **Angular resources** - Reactive data loading with automatic cancellation
+- **Tab-based state** - Integration with tab service for context-aware data loading
+- **Zod validation** - Runtime schema validation for all parameters
+- **Request cancellation** - AbortSignal support for all operations
+- **Type-safe transformations** - Full TypeScript integration with Zod schemas
+- **Comprehensive logging** - Integration with @isa/core/logging for debugging
+- **Caching support** - Automatic caching for country data
+
+## Quick Start
+
+### 1. Import and Inject Services
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { CrmSearchService, ShippingAddressService } from '@isa/crm/data-access';
+
+@Component({
+  selector: 'app-customer-detail',
+  template: '...'
+})
+export class CustomerDetailComponent {
+  #crmSearchService = inject(CrmSearchService);
+  #shippingAddressService = inject(ShippingAddressService);
+}
+```
+
+### 2. Fetch Customer Data
+
+```typescript
+async loadCustomer(customerId: number): Promise<void> {
+  const response = await this.#crmSearchService.fetchCustomer({
+    customerId: customerId,
+    eagerLoading: 3  // Load related data
+  });
+
+  const customer = response.result;
+  console.log(`Customer: ${customer.firstName} ${customer.lastName}`);
+  console.log(`Customer number: ${customer.customerNumber}`);
+}
+```
+
+### 3. Use Angular Resources for Reactive Loading
+
+```typescript
+import { Component } from '@angular/core';
+import { CustomerResource } from '@isa/crm/data-access';
+
+@Component({
+  selector: 'app-customer-view',
+  providers: [CustomerResource],
+  template: `
+    @if (customerResource.resource.value(); as customer) {
+      <div>{{ customer.firstName }} {{ customer.lastName }}</div>
+    } @else if (customerResource.resource.isLoading()) {
+      <div>Loading customer...</div>
+    } @else if (customerResource.resource.error()) {
+      <div>Error loading customer</div>
+    }
+  `
+})
+export class CustomerViewComponent {
+  customerResource = inject(CustomerResource);
+
+  ngOnInit() {
+    // Trigger customer load
+    this.customerResource.params({ customerId: 12345 });
+  }
+}
+```
+
+### 4. Fetch Shipping Addresses with Pagination
+
+```typescript
+async loadShippingAddresses(customerId: number): Promise<void> {
+  const response = await this.#shippingAddressService.fetchCustomerShippingAddresses({
+    customerId: customerId,
+    take: 10,  // Pagination: take 10 records
+    skip: 0    // Pagination: skip 0 records
+  });
+
+  console.log(`Total addresses: ${response.totalCount}`);
+  console.log(`Addresses loaded: ${response.result.length}`);
+
+  response.result.forEach(address => {
+    console.log(`${address.firstName} ${address.lastName}`);
+    console.log(`${address.address?.street}, ${address.address?.city}`);
+  });
+}
+```
+
+## Core Concepts
+
+### Customer Data Model
+
+The library provides comprehensive customer data management with the following structure:
+
+```typescript
+interface Customer {
+  id: number;                        // Customer ID
+  customerNumber: string;            // Customer number
+  customerType: CustomerType;        // Customer type enum
+  firstName?: string;                // First name
+  lastName?: string;                 // Last name
+  dateOfBirth?: string;             // Date of birth (ISO format)
+  gender?: Gender;                   // Gender enum
+  title?: string;                    // Title (Mr., Mrs., etc.)
+
+  // Address information
+  address?: Address;                 // Primary address
+
+  // Communication details
+  communicationDetails?: CommunicationDetails;  // Email, phone, etc.
+
+  // Organization (for business customers)
+  organisation?: Organisation;       // Organization details
+
+  // Related entities
+  bonusCard?: EntityContainer<BonusCard>;  // Primary bonus card
+  shippingAddresses?: EntityContainer<ShippingAddress>[];  // Shipping addresses
+  payers?: AssignedPayer[];         // Assigned payers
+
+  // Customer status
+  customerStatus?: number;           // Status code
+  statusComment?: string;            // Status comment
+  hasOnlineAccount?: boolean;        // Online account flag
+  isGuestAccount?: boolean;          // Guest account flag
+
+  // Metadata
+  orderCount?: number;               // Total order count
+  createdInBranch?: EntityContainer<Branch>;  // Creation branch
+  attributes?: EntityContainer<Attribute>[];  // Custom attributes
+  linkedRecords?: LinkedRecord[];   // Linked records
+
+  // Comments
+  agentComment?: string;             // Agent comment
+  deactivationComment?: string;      // Deactivation comment
+
+  // Settings
+  preferredPaymentType?: number;     // Preferred payment type
+  notificationChannels?: NotificationChannel;  // Notification preferences
+  campaignCode?: string;             // Campaign code
+  fetchOnDeliveryNote?: boolean;     // Delivery note flag
+}
+```
+
+### Customer Types
+
+```typescript
+enum CustomerType {
+  NotSet = 0,        // Not specified
+  Private = 1,       // Private customer
+  Business = 2,      // Business customer
+  Employee = 4,      // Employee
+}
+```
+
+### Shipping Address Model
+
+```typescript
+interface ShippingAddress {
+  id: number;                        // Shipping address ID
+  firstName?: string;                // First name
+  lastName?: string;                 // Last name
+  gender?: Gender;                   // Gender enum
+  title?: string;                    // Title
+
+  // Address details
+  address?: Address;                 // Address information
+
+  // Communication
+  communicationDetails?: CommunicationDetails;  // Contact information
+
+  // Organization (for business addresses)
+  organisation?: Organisation;       // Organization details
+
+  // Address metadata
+  type?: number;                     // Address type
+  validated?: string;                // Validation timestamp
+  validationResult?: number;         // Validation result code
+
+  // Comments
+  agentomment?: string;              // Agent comment (typo in API)
+}
+```
+
+### Bonus Card Model
+
+```typescript
+interface BonusCardInfo {
+  id: number;                        // Bonus card ID
+  cardNumber?: string;               // Card number
+  cardProvider?: number;             // Card provider ID
+  bonusValue?: number;               // Current bonus value
+
+  // Card status
+  isLocked?: boolean;                // Locked flag
+  isPaymentEnabled?: boolean;        // Payment enabled flag
+  markedAsLost?: string;            // Lost timestamp
+
+  // Validity
+  validFrom?: string;                // Valid from date (ISO format)
+  validThrough?: string;             // Valid through date (ISO format)
+
+  // Suspension
+  suspensionComment?: string;        // Suspension comment
+
+  // Extended properties (from BonusCardInfo model)
+  firstName: string;                 // Card holder first name
+  lastName: string;                  // Card holder last name
+  isActive: boolean;                 // Active status
+  isPrimary: boolean;                // Primary card flag
+  totalPoints: number;               // Total points accumulated
+}
+```
+
+### Payer Model
+
+```typescript
+interface Payer {
+  id: number;                        // Payer ID
+  payerNumber?: string;              // Payer number
+  payerType?: PayerType;            // Payer type enum
+  firstName?: string;                // First name
+  lastName?: string;                 // Last name
+  gender?: Gender;                   // Gender enum
+  title?: string;                    // Title
+
+  // Address and communication
+  address?: Address;                 // Primary address
+  communicationDetails?: CommunicationDetails;  // Contact details
+  organisation?: Organisation;       // Organization (for business payers)
+
+  // Payer status
+  payerStatus?: PayerStatus;        // Status information
+  payerGroup?: string;               // Payer group
+
+  // Payment settings
+  paymentTypes?: PaymentSettings[];  // Allowed payment types
+  defaultPaymentPeriod?: number;     // Default payment period (days)
+  standardInvoiceText?: string;      // Standard invoice text
+
+  // Flags
+  isGuestAccount?: boolean;          // Guest account flag
+
+  // Comments
+  agentComment?: string;             // Agent comment
+  statusComment?: string;            // Status comment
+  statusChangeComment?: string;      // Status change comment
+  deactivationComment?: string;      // Deactivation comment
+
+  // Label
+  label?: EntityContainer<Label>;   // Label information
+}
+```
+
+### Angular Resource Pattern
+
+The library uses Angular's resource API for reactive data loading:
+
+```typescript
+// Resource automatically manages loading state, errors, and cancellation
+const customerResource = resource({
+  params: () => ({ customerId: 12345, eagerLoading: 3 }),
+  loader: async ({ params, abortSignal }) => {
+    const response = await service.fetchCustomer(params, abortSignal);
+    return response.result;
+  }
+});
+
+// In template:
+// customerResource.value() - Current data
+// customerResource.isLoading() - Loading state
+// customerResource.error() - Error state
+// customerResource.reload() - Manual reload
+```
+
+### Tab-Based State Management
+
+The library integrates with the tab service for context-aware data loading:
+
+```typescript
+// Metadata keys for tab storage
+const SELECTED_CUSTOMER_ID = 'crm-data-access.selectedCustomerId';
+const SELECTED_SHIPPING_ADDRESS_ID = 'crm-data-access.selectedShippingAddressId';
+const SELECTED_PAYER_ADDRESS_ID = 'crm-data-access.selectedPayerAddressId';
+
+// Store selected customer ID in current tab
+crmTabMetadataService.setSelectedCustomerId(tabId, 12345);
+
+// Retrieve selected customer ID from tab
+const customerId = crmTabMetadataService.selectedCustomerId(tabId);
+```
+
+### Validation with Zod
+
+All input parameters are validated using Zod schemas:
+
+```typescript
+// Example: Customer fetch params validation
+const params = {
+  customerId: '123',        // String coerced to number
+  eagerLoading: 3
+};
+
+// Validation happens automatically
+const result = await service.fetchCustomer(params);
+// Throws ZodError if validation fails
+```
+
+## API Reference
+
+### CrmSearchService
+
+Main service for fetching customer and bonus card data.
+
+#### `fetchCustomer(params, abortSignal?): Promise<ResponseArgs<Customer>>`
+
+Fetches a single customer by ID with optional eager loading.
+
+**Parameters:**
+- `params: FetchCustomerInput` - Customer fetch parameters (automatically validated)
+  - `customerId: number` - Customer ID (required)
+  - `eagerLoading?: number` - Eager loading level (optional, controls related data loading)
+- `abortSignal?: AbortSignal` - Optional abort signal for request cancellation
+
+**Returns:** Promise resolving to ResponseArgs containing Customer data
+
+**Eager Loading Levels:**
+- `0` - Minimal data (customer record only)
+- `1` - Basic related data
+- `2` - Extended related data
+- `3` - Full related data (default in resources)
+
+**Example:**
+```typescript
+const response = await service.fetchCustomer({
+  customerId: 12345,
+  eagerLoading: 3
+});
+
+const customer = response.result;
+console.log(`${customer.firstName} ${customer.lastName}`);
+console.log(`Bonus card: ${customer.bonusCard?.entity?.cardNumber}`);
+```
+
+#### `fetchCustomerCards(params, abortSignal?): Promise<ResponseArgs<BonusCardInfo[]>>`
+
+Fetches all bonus cards for a customer.
+
+**Parameters:**
+- `params: FetchCustomerCardsInput` - Bonus card fetch parameters
+  - `customerId: number` - Customer ID (required)
+- `abortSignal?: AbortSignal` - Optional abort signal for request cancellation
+
+**Returns:** Promise resolving to ResponseArgs containing array of BonusCardInfo
+
+**Example:**
+```typescript
+const response = await service.fetchCustomerCards({
+  customerId: 12345
+});
+
+const cards = response.result;
+cards.forEach(card => {
+  console.log(`Card ${card.cardNumber}: ${card.totalPoints} points`);
+  if (card.isPrimary) {
+    console.log('This is the primary card');
+  }
+});
+```
+
+### ShippingAddressService
+
+Service for managing customer shipping addresses.
+
+#### `fetchCustomerShippingAddresses(params, abortSignal?): Promise<ListResponseArgs<ShippingAddress>>`
+
+Fetches shipping addresses for a customer with pagination support.
+
+**Parameters:**
+- `params: FetchCustomerShippingAddressesInput` - Shipping address fetch parameters
+  - `customerId: number` - Customer ID (required)
+  - `take?: number | null` - Number of records to retrieve (optional, for pagination)
+  - `skip?: number | null` - Number of records to skip (optional, for pagination)
+- `abortSignal?: AbortSignal` - Optional abort signal for request cancellation
+
+**Returns:** Promise resolving to ListResponseArgs with ShippingAddress array and totalCount
+
+**Example:**
+```typescript
+// Fetch first 10 shipping addresses
+const response = await service.fetchCustomerShippingAddresses({
+  customerId: 12345,
+  take: 10,
+  skip: 0
+});
+
+console.log(`Total addresses: ${response.totalCount}`);
+console.log(`Loaded: ${response.result.length}`);
+
+response.result.forEach(address => {
+  console.log(`${address.firstName} ${address.lastName}`);
+  console.log(`${address.address?.city}, ${address.address?.postalCode}`);
+});
+
+// Fetch next page
+const nextPage = await service.fetchCustomerShippingAddresses({
+  customerId: 12345,
+  take: 10,
+  skip: 10
+});
+```
+
+#### `fetchShippingAddress(params, abortSignal?): Promise<ResponseArgs<ShippingAddress>>`
+
+Fetches a single shipping address by ID.
+
+**Parameters:**
+- `params: FetchShippingAddressInput` - Shipping address fetch parameters
+  - `shippingAddressId: number` - Shipping address ID (required)
+- `abortSignal?: AbortSignal` - Optional abort signal for request cancellation
+
+**Returns:** Promise resolving to ResponseArgs containing ShippingAddress
+
+**Example:**
+```typescript
+const response = await service.fetchShippingAddress({
+  shippingAddressId: 67890
+});
+
+const address = response.result;
+console.log(`Address: ${address.address?.street}`);
+console.log(`City: ${address.address?.city}`);
+console.log(`Validated: ${address.validated}`);
+```
+
+### CountryService
+
+Service for retrieving country information with automatic caching.
+
+#### `getCountries(abortSignal?): Promise<Country[]>`
+
+Retrieves all available countries with automatic caching.
+
+**Parameters:**
+- `abortSignal?: AbortSignal` - Optional abort signal for request cancellation
+
+**Returns:** Promise resolving to array of Country objects
+
+**Caching:** Results are automatically cached using the `@Cache()` decorator
+
+**Example:**
+```typescript
+const countries = await service.getCountries();
+
+countries.forEach(country => {
+  console.log(`${country.name} (${country.code})`);
+});
+
+// Second call returns cached result
+const cachedCountries = await service.getCountries();
+```
+
+### CrmTabMetadataService
+
+Service for managing CRM-related metadata in tabs.
+
+#### `selectedCustomerId(tabId): number | undefined`
+
+Retrieves the selected customer ID from tab metadata.
+
+**Parameters:**
+- `tabId: number` - Tab ID
+
+**Returns:** Customer ID or undefined if not set
+
+#### `setSelectedCustomerId(tabId, customerId)`
+
+Stores the selected customer ID in tab metadata.
+
+**Parameters:**
+- `tabId: number` - Tab ID
+- `customerId: number | undefined` - Customer ID to store
+
+#### `selectedShippingAddressId(tabId): number | undefined`
+
+Retrieves the selected shipping address ID from tab metadata.
+
+**Parameters:**
+- `tabId: number` - Tab ID
+
+**Returns:** Shipping address ID or undefined if not set
+
+#### `setSelectedShippingAddressId(tabId, shippingAddressId)`
+
+Stores the selected shipping address ID in tab metadata.
+
+**Parameters:**
+- `tabId: number` - Tab ID
+- `shippingAddressId: number | undefined` - Shipping address ID to store
+
+#### `selectedPayerId(tabId): number | undefined`
+
+Retrieves the selected payer ID from tab metadata.
+
+**Parameters:**
+- `tabId: number` - Tab ID
+
+**Returns:** Payer ID or undefined if not set
+
+#### `setSelectedPayerId(tabId, payerAddressId)`
+
+Stores the selected payer ID in tab metadata.
+
+**Parameters:**
+- `tabId: number` - Tab ID
+- `payerAddressId: number | undefined` - Payer ID to store
+
+**Example:**
+```typescript
+// Store customer ID in current tab
+const tabId = tabService.activatedTabId();
+crmTabMetadataService.setSelectedCustomerId(tabId, 12345);
+
+// Later, retrieve customer ID from same tab
+const customerId = crmTabMetadataService.selectedCustomerId(tabId);
+if (customerId) {
+  console.log(`Selected customer: ${customerId}`);
+}
+```
+
+### CustomerFacade
+
+Pass-through facade for customer operations.
+
+#### `fetchCustomer(params, abortSignal?): Promise<Customer | undefined>`
+
+Simplified customer fetch that returns the customer directly (unwraps ResponseArgs).
+
+**Parameters:**
+- `params: FetchCustomerInput` - Customer fetch parameters
+- `abortSignal?: AbortSignal` - Optional abort signal
+
+**Returns:** Promise resolving to Customer or undefined
+
+**Example:**
+```typescript
+const customer = await facade.fetchCustomer({
+  customerId: 12345,
+  eagerLoading: 2
+});
+
+if (customer) {
+  console.log(`Customer: ${customer.firstName} ${customer.lastName}`);
+}
+```
+
+### CustomerCardsFacade
+
+Pass-through facade for bonus card operations.
+
+#### `get(params, abortSignal?): Promise<ResponseArgs<BonusCardInfo[]>>`
+
+Fetches customer bonus cards.
+
+**Parameters:**
+- `params: FetchCustomerCardsInput` - Bonus card fetch parameters
+- `abortSignal?: AbortSignal` - Optional abort signal
+
+**Returns:** Promise resolving to ResponseArgs with BonusCardInfo array
+
+### Resources
+
+Angular resource-based data loading classes for reactive data management.
+
+#### `CustomerResource`
+
+Base resource for loading customer data.
+
+**Properties:**
+- `resource: Resource<Customer | undefined>` - Angular resource for customer data
+
+**Methods:**
+- `params(params)` - Update resource parameters
+  - `customerId?: number` - Customer ID
+  - `eagerLoading?: number` - Eager loading level (default: 3)
+
+**Example:**
+```typescript
+@Component({
+  providers: [CustomerResource]
+})
+export class CustomerComponent {
+  customerResource = inject(CustomerResource);
+
+  ngOnInit() {
+    this.customerResource.params({ customerId: 12345 });
+  }
+}
+```
+
+#### `SelectedCustomerResource`
+
+Extended resource that automatically loads customer based on tab metadata.
+
+**Additional Features:**
+- Automatically syncs with `CrmTabMetadataService.selectedCustomerId`
+- Reactively updates when tab selection changes
+
+**Methods:**
+- `setEagerLoading(eagerLoading)` - Update eager loading level
+
+**Example:**
+```typescript
+@Component({
+  providers: [SelectedCustomerResource]
+})
+export class CustomerDetailComponent {
+  selectedCustomerResource = inject(SelectedCustomerResource);
+
+  ngOnInit() {
+    // Automatically loads customer based on tab metadata
+    this.selectedCustomerResource.setEagerLoading(3);
+  }
+}
+```
+
+#### `CustomerShippingAddressesResource`
+
+Base resource for loading customer shipping addresses.
+
+**Properties:**
+- `resource: Resource<ShippingAddress[] | undefined>` - Angular resource for shipping addresses
+
+**Methods:**
+- `params(params)` - Update resource parameters
+  - `customerId?: number` - Customer ID
+  - `take?: number | null` - Pagination: number of records
+  - `skip?: number | null` - Pagination: offset
+
+**Example:**
+```typescript
+@Component({
+  providers: [CustomerShippingAddressesResource]
+})
+export class ShippingAddressesComponent {
+  addressesResource = inject(CustomerShippingAddressesResource);
+
+  loadAddresses(customerId: number, page: number, pageSize: number) {
+    this.addressesResource.params({
+      customerId,
+      take: pageSize,
+      skip: page * pageSize
+    });
+  }
+}
+```
+
+#### `SelectedCustomerShippingAddressesResource`
+
+Extended resource that automatically loads addresses based on tab metadata.
+
+**Additional Features:**
+- Automatically syncs with `CrmTabMetadataService.selectedCustomerId`
+- Reactively updates when tab customer selection changes
+
+#### `CustomerShippingAddressResource`
+
+Base resource for loading a single shipping address.
+
+**Properties:**
+- `resource: Resource<ShippingAddress | undefined>` - Angular resource for single address
+
+**Methods:**
+- `params(params)` - Update resource parameters
+  - `shippingAddressId?: number` - Shipping address ID
+
+#### `SelectedCustomerShippingAddressResource`
+
+Extended resource that automatically loads address based on tab metadata.
+
+**Additional Features:**
+- Automatically syncs with `CrmTabMetadataService.selectedShippingAddressId`
+
+#### `CustomerBonusCardsResource`
+
+Base resource for loading customer bonus cards.
+
+**Properties:**
+- `resource: Resource<BonusCardInfo[] | undefined>` - Angular resource for bonus cards
+
+**Methods:**
+- `params(params)` - Update resource parameters
+  - `customerId?: number` - Customer ID
+
+#### `SelectedCustomerBonusCardsResource`
+
+Extended resource that automatically loads cards based on tab metadata.
+
+**Additional Features:**
+- Automatically syncs with `CrmTabMetadataService.selectedCustomerId`
+
+#### `CountryResource`
+
+Resource for loading country list with automatic caching.
+
+**Properties:**
+- `resource: Resource<Country[]>` - Angular resource for countries
+
+**Features:**
+- Automatically caches results via CountryService
+- No parameters required (loads all countries)
+
+**Example:**
+```typescript
+@Component({
+  providers: [CountryResource]
+})
+export class CountrySelectComponent {
+  countryResource = inject(CountryResource);
+
+  // In template: countryResource.resource.value()
+}
+```
+
+### Helper Functions
+
+#### `getCustomerName(customer): string`
+
+Generates a formatted customer name from first and last name.
+
+**Parameters:**
+- `customer: { firstName?: string; lastName?: string } | undefined` - Customer object
+
+**Returns:** Formatted name string (trimmed, handles missing values)
+
+**Example:**
+```typescript
+import { getCustomerName } from '@isa/crm/data-access';
+
+const name = getCustomerName(customer);
+console.log(name);  // "John Doe"
+
+const nameWithMissing = getCustomerName({ firstName: 'John' });
+console.log(nameWithMissing);  // "John"
+
+const emptyName = getCustomerName({});
+console.log(emptyName);  // ""
+```
+
+#### `getPrimaryBonusCard(bonusCards): BonusCardInfo | undefined`
+
+Finds the primary bonus card from an array of bonus cards.
+
+**Parameters:**
+- `bonusCards: BonusCardInfo[]` - Array of bonus cards
+
+**Returns:** Primary bonus card or undefined if none found
+
+**Example:**
+```typescript
+import { getPrimaryBonusCard } from '@isa/crm/data-access';
+
+const primaryCard = getPrimaryBonusCard(bonusCards);
+if (primaryCard) {
+  console.log(`Primary card: ${primaryCard.cardNumber}`);
+  console.log(`Points: ${primaryCard.totalPoints}`);
+}
+```
+
+## Usage Examples
+
+### Loading Customer with Eager Loading
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { CrmSearchService } from '@isa/crm/data-access';
+
+@Component({
+  selector: 'app-customer-detail',
+  template: '...'
+})
+export class CustomerDetailComponent {
+  #crmSearchService = inject(CrmSearchService);
+
+  async loadCustomerWithAllData(customerId: number): Promise<void> {
+    const response = await this.#crmSearchService.fetchCustomer({
+      customerId: customerId,
+      eagerLoading: 3  // Load all related data
+    });
+
+    const customer = response.result;
+
+    // Access customer data
+    console.log(`Name: ${customer.firstName} ${customer.lastName}`);
+    console.log(`Customer #: ${customer.customerNumber}`);
+    console.log(`Email: ${customer.communicationDetails?.email}`);
+
+    // Access related data loaded via eager loading
+    if (customer.bonusCard?.entity) {
+      console.log(`Bonus card: ${customer.bonusCard.entity.cardNumber}`);
+    }
+
+    if (customer.payers && customer.payers.length > 0) {
+      console.log(`Assigned payers: ${customer.payers.length}`);
+      const defaultPayer = customer.payers.find(p => p.isDefault === 'true');
+      if (defaultPayer?.payer?.entity) {
+        console.log(`Default payer: ${defaultPayer.payer.entity.payerNumber}`);
+      }
+    }
+  }
+}
+```
+
+### Using Resource for Reactive Customer Loading
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { CustomerResource } from '@isa/crm/data-access';
+
+@Component({
+  selector: 'app-customer-view',
+  standalone: true,
+  providers: [CustomerResource],
+  template: `
+    @if (customerResource.resource.value(); as customer) {
+      <div class="customer-details">
+        <h2>{{ customer.firstName }} {{ customer.lastName }}</h2>
+        <p>Customer Number: {{ customer.customerNumber }}</p>
+        <p>Email: {{ customer.communicationDetails?.email }}</p>
+
+        @if (customer.address) {
+          <div class="address">
+            <h3>Address</h3>
+            <p>{{ customer.address.street }}</p>
+            <p>{{ customer.address.postalCode }} {{ customer.address.city }}</p>
+          </div>
+        }
+      </div>
+    } @else if (customerResource.resource.isLoading()) {
+      <div class="loading">Loading customer data...</div>
+    } @else if (customerResource.resource.error()) {
+      <div class="error">Error loading customer</div>
+    }
+  `
+})
+export class CustomerViewComponent {
+  customerResource = inject(CustomerResource);
+
+  ngOnInit() {
+    // Trigger customer load
+    this.customerResource.params({
+      customerId: 12345,
+      eagerLoading: 2  // Load with moderate related data
+    });
+  }
+
+  reloadCustomer() {
+    this.customerResource.resource.reload();
+  }
+}
+```
+
+### Tab-Based Customer Selection
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { SelectedCustomerResource, CrmTabMetadataService } from '@isa/crm/data-access';
+import { TabService } from '@isa/core/tabs';
+
+@Component({
+  selector: 'app-customer-tab',
+  standalone: true,
+  providers: [SelectedCustomerResource],
+  template: `
+    @if (selectedCustomerResource.resource.value(); as customer) {
+      <div>
+        <h2>Selected Customer</h2>
+        <p>{{ customer.firstName }} {{ customer.lastName }}</p>
+        <button (click)="clearSelection()">Clear Selection</button>
+      </div>
+    } @else {
+      <div>No customer selected</div>
+    }
+  `
+})
+export class CustomerTabComponent {
+  #tabService = inject(TabService);
+  #crmTabMetadata = inject(CrmTabMetadataService);
+  selectedCustomerResource = inject(SelectedCustomerResource);
+
+  selectCustomer(customerId: number) {
+    const tabId = this.#tabService.activatedTabId();
+    if (tabId) {
+      // Store in tab metadata - resource automatically reloads
+      this.#crmTabMetadata.setSelectedCustomerId(tabId, customerId);
+    }
+  }
+
+  clearSelection() {
+    const tabId = this.#tabService.activatedTabId();
+    if (tabId) {
+      this.#crmTabMetadata.setSelectedCustomerId(tabId, undefined);
+    }
+  }
+}
+```
+
+### Paginated Shipping Addresses
+
+```typescript
+import { Component, inject, signal } from '@angular/core';
+import { ShippingAddressService, ShippingAddress } from '@isa/crm/data-access';
+
+@Component({
+  selector: 'app-shipping-addresses',
+  template: '...'
+})
+export class ShippingAddressesComponent {
+  #shippingAddressService = inject(ShippingAddressService);
+
+  currentPage = signal(0);
+  pageSize = signal(10);
+  totalCount = signal(0);
+  addresses = signal<ShippingAddress[]>([]);
+
+  async loadPage(customerId: number, page: number): Promise<void> {
+    const response = await this.#shippingAddressService.fetchCustomerShippingAddresses({
+      customerId: customerId,
+      take: this.pageSize(),
+      skip: page * this.pageSize()
+    });
+
+    this.addresses.set(response.result);
+    this.totalCount.set(response.totalCount);
+    this.currentPage.set(page);
+
+    console.log(`Loaded page ${page + 1} of ${this.totalPages()}`);
+    console.log(`Showing ${response.result.length} of ${response.totalCount} addresses`);
+  }
+
+  totalPages(): number {
+    return Math.ceil(this.totalCount() / this.pageSize());
+  }
+
+  nextPage(customerId: number): void {
+    if (this.currentPage() < this.totalPages() - 1) {
+      this.loadPage(customerId, this.currentPage() + 1);
+    }
+  }
+
+  previousPage(customerId: number): void {
+    if (this.currentPage() > 0) {
+      this.loadPage(customerId, this.currentPage() - 1);
+    }
+  }
+}
+```
+
+### Using Resource for Shipping Addresses
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { SelectedCustomerShippingAddressesResource } from '@isa/crm/data-access';
+
+@Component({
+  selector: 'app-customer-shipping-list',
+  standalone: true,
+  providers: [SelectedCustomerShippingAddressesResource],
+  template: `
+    @if (addressesResource.resource.value(); as addresses) {
+      <div class="shipping-addresses">
+        <h3>Shipping Addresses ({{ addresses.length }})</h3>
+        @for (address of addresses; track address.id) {
+          <div class="address-card">
+            <h4>{{ address.firstName }} {{ address.lastName }}</h4>
+            @if (address.address) {
+              <p>{{ address.address.street }}</p>
+              <p>{{ address.address.postalCode }} {{ address.address.city }}</p>
+            }
+            @if (address.validated) {
+              <span class="validated">Validated</span>
+            }
+          </div>
+        }
+      </div>
+    } @else if (addressesResource.resource.isLoading()) {
+      <div>Loading addresses...</div>
+    }
+  `
+})
+export class CustomerShippingListComponent {
+  addressesResource = inject(SelectedCustomerShippingAddressesResource);
+
+  // Resource automatically loads based on selected customer in tab metadata
+  // No manual parameter setting needed
+}
+```
+
+### Bonus Card Management
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { CrmSearchService, getPrimaryBonusCard } from '@isa/crm/data-access';
+
+@Component({
+  selector: 'app-bonus-cards',
+  template: '...'
+})
+export class BonusCardsComponent {
+  #crmSearchService = inject(CrmSearchService);
+
+  async loadBonusCards(customerId: number): Promise<void> {
+    const response = await this.#crmSearchService.fetchCustomerCards({
+      customerId: customerId
+    });
+
+    const cards = response.result;
+
+    // Find primary card
+    const primaryCard = getPrimaryBonusCard(cards);
+    if (primaryCard) {
+      console.log(`Primary Card: ${primaryCard.cardNumber}`);
+      console.log(`Card Holder: ${primaryCard.firstName} ${primaryCard.lastName}`);
+      console.log(`Total Points: ${primaryCard.totalPoints}`);
+      console.log(`Bonus Value: ${primaryCard.bonusValue}`);
+      console.log(`Active: ${primaryCard.isActive}`);
+
+      if (primaryCard.isLocked) {
+        console.warn('Card is locked!');
+      }
+
+      if (primaryCard.markedAsLost) {
+        console.warn(`Card marked as lost on ${primaryCard.markedAsLost}`);
+      }
+    }
+
+    // List all cards
+    console.log(`Total cards: ${cards.length}`);
+    cards.forEach((card, index) => {
+      console.log(`Card ${index + 1}: ${card.cardNumber}`);
+      console.log(`  Points: ${card.totalPoints}`);
+      console.log(`  Payment enabled: ${card.isPaymentEnabled}`);
+      if (card.validThrough) {
+        console.log(`  Valid through: ${card.validThrough}`);
+      }
+    });
+  }
+}
+```
+
+### Country Selection with Caching
+
+```typescript
+import { Component, inject, signal } from '@angular/core';
+import { CountryService, Country } from '@isa/crm/data-access';
+
+@Component({
+  selector: 'app-country-select',
+  template: `
+    <select [(ngModel)]="selectedCountry">
+      @for (country of countries(); track country.id) {
+        <option [value]="country.id">{{ country.name }}</option>
+      }
+    </select>
+  `
+})
+export class CountrySelectComponent {
+  #countryService = inject(CountryService);
+  countries = signal<Country[]>([]);
+  selectedCountry = signal<string>('');
+
+  async ngOnInit() {
+    // First call fetches from API
+    const countries = await this.#countryService.getCountries();
+    this.countries.set(countries);
+
+    // Subsequent calls return cached result (instant)
+    const cachedCountries = await this.#countryService.getCountries();
+    console.log('Same result from cache:', countries === cachedCountries);
+  }
+}
+```
+
+### Using CountryResource (Recommended)
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { CountryResource } from '@isa/crm/data-access';
+
+@Component({
+  selector: 'app-country-dropdown',
+  standalone: true,
+  providers: [CountryResource],
+  template: `
+    @if (countryResource.resource.value(); as countries) {
+      <select>
+        @for (country of countries; track country.id) {
+          <option [value]="country.id">{{ country.name }}</option>
+        }
+      </select>
+    } @else if (countryResource.resource.isLoading()) {
+      <div>Loading countries...</div>
+    }
+  `
+})
+export class CountryDropdownComponent {
+  countryResource = inject(CountryResource);
+  // Resource automatically loads on initialization
+}
+```
+
+### Request Cancellation
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { CrmSearchService } from '@isa/crm/data-access';
+
+@Component({
+  selector: 'app-search',
+  template: '...'
+})
+export class SearchComponent {
+  #crmSearchService = inject(CrmSearchService);
+  #currentRequest?: AbortController;
+
+  async searchCustomer(customerId: number): Promise<void> {
+    // Cancel previous request if still running
+    this.#currentRequest?.abort();
+
+    // Create new abort controller
+    this.#currentRequest = new AbortController();
+
+    try {
+      const response = await this.#crmSearchService.fetchCustomer(
+        { customerId, eagerLoading: 2 },
+        this.#currentRequest.signal
+      );
+
+      console.log('Customer loaded:', response.result);
+    } catch (error) {
+      if (error.name === 'AbortError') {
+        console.log('Request cancelled');
+      } else {
+        console.error('Error loading customer:', error);
+      }
+    } finally {
+      this.#currentRequest = undefined;
+    }
+  }
+
+  cancelSearch(): void {
+    this.#currentRequest?.abort();
+  }
+}
+```
+
+### Handling Customer Name Formatting
+
+```typescript
+import { Component, inject, signal } from '@angular/core';
+import { CustomerFacade, getCustomerName } from '@isa/crm/data-access';
+
+@Component({
+  selector: 'app-customer-display',
+  template: `
+    <div>{{ displayName() }}</div>
+  `
+})
+export class CustomerDisplayComponent {
+  #customerFacade = inject(CustomerFacade);
+  displayName = signal<string>('');
+
+  async loadCustomer(customerId: number): Promise<void> {
+    const customer = await this.#customerFacade.fetchCustomer({
+      customerId: customerId
+    });
+
+    // Generate formatted name
+    const name = getCustomerName(customer);
+    this.displayName.set(name || 'Unknown Customer');
+
+    // Helper handles edge cases:
+    // - Missing first or last name
+    // - Both names missing
+    // - Extra whitespace trimming
+  }
+}
+```
+
+## Resource Pattern
+
+### Understanding Angular Resources
+
+Angular resources provide a reactive way to load asynchronous data with automatic state management:
+
+```typescript
+// Resource definition
+const customerResource = resource({
+  params: () => this.#params(),  // Reactive parameters
+  loader: async ({ params, abortSignal }) => {
+    // Async data loading
+    return await service.fetch(params, abortSignal);
+  }
+});
+
+// Resource automatically provides:
+// - value(): Current data value
+// - isLoading(): Loading state
+// - error(): Error state
+// - status(): 'idle' | 'loading' | 'resolved' | 'error'
+// - reload(): Manual refresh
+// - hasValue(): True if data is available
+```
+
+### Resource Lifecycle
+
+1. **Initialization**: Resource created with loader function
+2. **Reactive Updates**: When params signal changes, loader automatically re-runs
+3. **Automatic Cancellation**: Previous requests cancelled when new params trigger reload
+4. **State Management**: Loading, error, and data states automatically tracked
+5. **Template Integration**: Use signals in templates with @if control flow
+
+### Base vs Selected Resources
+
+The library provides two patterns for each resource type:
+
+**Base Resources** (manual parameter control):
+```typescript
+// CustomerResource - manual control
+customerResource.params({ customerId: 12345 });
+```
+
+**Selected Resources** (tab metadata integration):
+```typescript
+// SelectedCustomerResource - automatic tab integration
+// Automatically loads based on tab metadata
+// No manual params() call needed
+```
+
+### When to Use Each Pattern
+
+**Use Base Resources When:**
+- Data loading is not tied to tab state
+- You need explicit control over parameters
+- Component is reusable across different contexts
+
+**Use Selected Resources When:**
+- Data is tied to tab-based navigation
+- You want automatic synchronization with tab state
+- Component is used in tab-specific context
+
+## Tab Metadata Management
+
+### Metadata Storage
+
+The library stores CRM-related IDs in tab metadata:
+
+```typescript
+// Storage keys (namespaced)
+const SELECTED_CUSTOMER_ID = 'crm-data-access.selectedCustomerId';
+const SELECTED_SHIPPING_ADDRESS_ID = 'crm-data-access.selectedShippingAddressId';
+const SELECTED_PAYER_ADDRESS_ID = 'crm-data-access.selectedPayerAddressId';
+```
+
+### Metadata Lifecycle
+
+1. **Set**: Store ID when user selects entity
+2. **Retrieve**: Read ID when component needs data
+3. **React**: Resources automatically react to metadata changes
+4. **Clear**: Set to undefined when selection is cleared
+5. **Persist**: Metadata persists during tab navigation
+
+### Integration with Tab Service
+
+```typescript
+// Get current tab ID
+const tabId = tabService.activatedTabId();
+
+// Store customer ID in tab
+crmTabMetadataService.setSelectedCustomerId(tabId, 12345);
+
+// Later, retrieve customer ID
+const customerId = crmTabMetadataService.selectedCustomerId(tabId);
+
+// Resources react automatically
+@Component({
+  providers: [SelectedCustomerResource]  // Auto-loads from tab metadata
+})
+```
+
+### Validation
+
+All metadata values are validated using Zod schemas:
+
+```typescript
+// Metadata is validated as optional number
+getMetadataHelper(
+  tabId,
+  SELECTED_CUSTOMER_ID,
+  z.number().optional(),  // Validation schema
+  tabService.entityMap()
+);
+```
+
+## Validation with Zod
+
+### Input Validation
+
+All service methods validate input parameters using Zod schemas:
+
+```typescript
+// Schema definition
+const FetchCustomerSchema = z.object({
+  customerId: z.number().int(),      // Integer required
+  eagerLoading: z.number().optional() // Optional number
+});
+
+// Automatic validation
+const result = await service.fetchCustomer({
+  customerId: '123',  // String coerced to number
+  eagerLoading: 3
+});
+// Throws ZodError if validation fails
+```
+
+### Type Coercion
+
+Zod schemas support automatic type coercion:
+
+```typescript
+// String to number coercion
+customerId: z.number().int()  // '123' → 123
+
+// Optional with default
+eagerLoading: z.number().optional()  // undefined if not provided
+
+// Nullable values
+take: z.number().int().optional().nullable()  // Allows null or undefined
+```
+
+### Validation Errors
+
+Zod validation errors provide detailed information:
+
+```typescript
+try {
+  await service.fetchCustomer({ customerId: 'invalid' });
+} catch (error) {
+  if (error instanceof ZodError) {
+    console.error('Validation errors:', error.errors);
+    // error.errors contains array of validation issues
+  }
+}
+```
+
+### Schema Types
+
+The library exports both inferred types and input types:
+
+```typescript
+// Inferred type (after validation)
+type FetchCustomer = z.infer<typeof FetchCustomerSchema>;
+
+// Input type (before validation, with coercion)
+type FetchCustomerInput = z.input<typeof FetchCustomerSchema>;
+
+// Use input type for function parameters
+async fetchCustomer(params: FetchCustomerInput): Promise<...>
+```
+
+## Error Handling
+
+### Error Types
+
+#### ResponseArgsError
+
+Thrown when the API returns an error:
+
+```typescript
+import { ResponseArgsError } from '@isa/common/data-access';
+
+try {
+  await service.fetchCustomer({ customerId: 99999 });
+} catch (error) {
+  if (error instanceof ResponseArgsError) {
+    console.error('API error:', error.message);
+  }
+}
+```
+
+#### ZodError
+
+Thrown when input validation fails:
+
+```typescript
+import { ZodError } from 'zod';
+
+try {
+  await service.fetchCustomer({ customerId: -1 });  // Negative ID invalid
+} catch (error) {
+  if (error instanceof ZodError) {
+    console.error('Validation error:', error.errors);
+  }
+}
+```
+
+### Service Error Handling
+
+Services handle errors gracefully and return fallback values:
+
+```typescript
+// CrmSearchService.fetchCustomer
+try {
+  const response = await firstValueFrom(req$);
+  return response as ResponseArgs<Customer>;
+} catch (error) {
+  this.#logger.error('Error fetching customer', error);
+  return undefined as unknown as ResponseArgs<Customer>;
+}
+```
+
+### Resource Error States
+
+Resources automatically track error states:
+
+```typescript
+@if (customerResource.resource.error(); as error) {
+  <div class="error">
+    Error loading customer: {{ error }}
+  </div>
+}
+```
+
+### Request Cancellation
+
+Use AbortSignal for request cancellation:
+
+```typescript
+const controller = new AbortController();
+
+// Start request
+const promise = service.fetchCustomer(
+  { customerId: 12345 },
+  controller.signal
+);
+
+// Cancel if needed
+controller.abort();
+
+try {
+  await promise;
+} catch (error) {
+  // Handle cancellation or other errors
+  console.log('Request cancelled or failed');
+}
+```
+
+### Logging
+
+All services include comprehensive logging:
+
+```typescript
+// Service initialization
+#logger = logger(() => ({
+  service: 'CrmSearchService'
+}));
+
+// Operation logging
+this.#logger.info('Fetching customer from API');
+this.#logger.debug('Successfully fetched customer');
+this.#logger.error('Error fetching customer', error);
+```
+
+## Testing
+
+The library uses **Vitest** with **Angular Testing Utilities** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test crm-data-access --skip-nx-cache
+
+# Run tests with coverage
+npx nx test crm-data-access --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test crm-data-access --watch
+```
+
+### Test Structure
+
+The library includes comprehensive unit tests covering:
+
+- **Service methods** - Tests for all CrmSearchService, ShippingAddressService, CountryService methods
+- **Validation** - Tests Zod schema validation for all input types
+- **Resources** - Tests Angular resource behavior and state management
+- **Tab metadata** - Tests CrmTabMetadataService integration
+- **Helper functions** - Tests getPrimaryBonusCard, getCustomerName utilities
+- **Error handling** - Tests API errors, validation failures, abort signal behavior
+- **Caching** - Tests CountryService caching decorator
+
+### Example Test
+
+```typescript
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { TestBed } from '@angular/core/testing';
+import { getPrimaryBonusCard } from './get-primary-bonus-card.helper';
+import { BonusCardInfo } from '../models';
+
+describe('getPrimaryBonusCard', () => {
+  it('should return the primary bonus card when one exists', () => {
+    // Arrange
+    const bonusCards: BonusCardInfo[] = [
+      {
+        firstName: 'John',
+        lastName: 'Doe',
+        isActive: true,
+        isPrimary: false,
+        totalPoints: 100,
+      } as BonusCardInfo,
+      {
+        firstName: 'Jane',
+        lastName: 'Smith',
+        isActive: true,
+        isPrimary: true,
+        totalPoints: 200,
+      } as BonusCardInfo,
+    ];
+
+    // Act
+    const result = getPrimaryBonusCard(bonusCards);
+
+    // Assert
+    expect(result).toBeDefined();
+    expect(result?.isPrimary).toBe(true);
+    expect(result?.firstName).toBe('Jane');
+  });
+
+  it('should return undefined when no primary bonus card exists', () => {
+    // Arrange
+    const bonusCards: BonusCardInfo[] = [
+      {
+        firstName: 'John',
+        lastName: 'Doe',
+        isActive: true,
+        isPrimary: false,
+        totalPoints: 100,
+      } as BonusCardInfo,
+    ];
+
+    // Act
+    const result = getPrimaryBonusCard(bonusCards);
+
+    // Assert
+    expect(result).toBeUndefined();
+  });
+});
+```
+
+## Architecture Notes
+
+### Current Architecture
+
+The library follows a layered architecture:
+
+```
+Components/Features
+       ↓
+  Resources (Angular resource API)
+       ↓
+  Facades (optional pass-through)
+       ↓
+  Services (business logic)
+       ↓
+├─→ CrmSearchService
+├─→ ShippingAddressService
+├─→ CountryService
+├─→ CrmTabMetadataService
+       ↓
+  Generated API Client (crm-api)
+       ↓
+  Zod Schemas (validation)
+```
+
+### Design Patterns
+
+#### Resource Pattern
+
+The library uses Angular's resource API for reactive data loading:
+
+**Benefits:**
+- Automatic loading state management
+- Built-in error handling
+- Automatic request cancellation
+- Reactive parameter updates
+- Template-friendly signals
+
+**Implementation:**
+```typescript
+resource({
+  params: () => signal(),     // Reactive parameters
+  loader: async ({ params, abortSignal }) => {
+    return await service.fetch(params, abortSignal);
+  }
+})
+```
+
+#### Tab Metadata Pattern
+
+Integration with tab service for context-aware data:
+
+**Benefits:**
+- State persists during tab navigation
+- Automatic synchronization across components
+- Clean separation of concerns
+- Type-safe metadata storage
+
+**Implementation:**
+```typescript
+// Store in tab
+crmTabMetadataService.setSelectedCustomerId(tabId, customerId);
+
+// Resource automatically reacts to changes
+effect(() => {
+  const tabId = this.#tabId();
+  const customerId = this.#customerMetadata.selectedCustomerId(tabId);
+  this.params({ customerId });
+});
+```
+
+#### Caching Pattern
+
+CountryService uses decorator-based caching:
+
+**Benefits:**
+- Reduces API calls
+- Improves performance
+- Transparent to consumers
+- Configurable TTL
+
+**Implementation:**
+```typescript
+@Cache()  // Decorator from @isa/common/decorators
+async getCountries(abortSignal?: AbortSignal): Promise<Country[]> {
+  // Method automatically cached
+}
+```
+
+### Known Architectural Considerations
+
+#### 1. Facade Evaluation (Low Priority)
+
+The facades (`CustomerFacade`, `CustomerCardsFacade`) are simple pass-through wrappers:
+
+**Current State:**
+- Minimal added value
+- Just delegate to services
+- CustomerFacade unwraps ResponseArgs
+
+**Recommendation:**
+- Consider removal if not needed for future abstraction
+- Direct service injection is simpler
+- Keep if planning orchestration logic
+
+**Impact:** Low risk, reduces one layer of indirection
+
+#### 2. Selected Resources vs Base Resources (Good Design)
+
+The library provides both base and selected variants of resources:
+
+**Current State:**
+- Base resources for manual control
+- Selected resources for tab integration
+- Clear separation of concerns
+
+**Strength:**
+- Flexible usage patterns
+- Reusable across contexts
+- Clean abstraction
+
+**Impact:** This is good architecture, no changes needed
+
+#### 3. Error Handling in Services (Medium Priority)
+
+Services return fallback values on error instead of throwing:
+
+**Current State:**
+```typescript
+catch (error) {
+  this.#logger.error('Error fetching customer', error);
+  return undefined as unknown as ResponseArgs<Customer>;
+}
+```
+
+**Consideration:**
+- Type assertion `as unknown as ResponseArgs` is not type-safe
+- Consumers don't know if undefined means error or not found
+- Errors are logged but not propagated
+
+**Alternative:**
+- Throw errors and let consumers handle
+- Return discriminated union: `{ success: true, data } | { success: false, error }`
+- Use Result/Either pattern
+
+**Impact:** Medium - affects error handling patterns
+
+#### 4. Schema Organization (Good Structure)
+
+Schemas are well-organized and comprehensive:
+
+**Strengths:**
+- Clear separation by entity
+- Proper input/output types
+- Zod validation integration
+- Extends common schemas
+
+**Best Practice:**
+- Maintains type safety throughout
+- Reusable schema composition
+
+### Performance Considerations
+
+1. **Automatic Caching** - CountryService caches results to minimize API calls
+2. **Resource Cancellation** - Resources automatically cancel pending requests
+3. **Eager Loading Control** - Configurable eager loading levels reduce over-fetching
+4. **Pagination Support** - Shipping addresses support pagination for large datasets
+5. **Reactive Updates** - Resources only reload when parameters change
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Batch Operations** - Support batch customer/address lookups
+2. **Offline Support** - Cache customer data for offline access
+3. **Search Functionality** - Add customer search capabilities
+4. **Mutation Operations** - Add create/update/delete operations
+5. **Optimistic Updates** - Resource pattern with optimistic UI updates
+6. **Error Recovery** - Automatic retry logic for transient failures
+7. **Analytics Integration** - Track data access patterns
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework (20.1.2)
+- `@generated/swagger/crm-api` - Generated CRM API client
+- `@isa/common/data-access` - Common data access utilities (ResponseArgs, catchResponseArgsErrorPipe, takeUntilAborted)
+- `@isa/common/decorators` - Caching decorator (@Cache)
+- `@isa/core/logging` - Logging service
+- `@isa/core/tabs` - Tab service and metadata helpers
+- `zod` - Schema validation library
+- `rxjs` - Reactive programming (firstValueFrom)
+
+### Path Alias
+
+Import from: `@isa/crm/data-access`
+
+### Generated API
+
+The library depends on the generated CRM API client:
+
+```typescript
+// Generated services used
+import { CustomerService, ShippingAddressService, CountryService } from '@generated/swagger/crm-api';
+
+// Generated types used
+import { BonusCardInfoDTO, CountryDTO, PayerDTO } from '@generated/swagger/crm-api';
+```
+
+To regenerate API clients after backend changes:
+```bash
+npm run generate:swagger
+```
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/crm/data-access/src/index.ts b/libs/crm/data-access/src/index.ts
index 82c690587..48cf23a51 100644
--- a/libs/crm/data-access/src/index.ts
+++ b/libs/crm/data-access/src/index.ts
@@ -3,4 +3,5 @@ export * from './lib/constants';
 export * from './lib/models';
 export * from './lib/resources';
 export * from './lib/helpers';
+export * from './lib/schemas';
 export * from './lib/services';
diff --git a/libs/crm/data-access/src/lib/facades/customer.facade.ts b/libs/crm/data-access/src/lib/facades/customer.facade.ts
index c7003a4a1..9ab75d779 100644
--- a/libs/crm/data-access/src/lib/facades/customer.facade.ts
+++ b/libs/crm/data-access/src/lib/facades/customer.facade.ts
@@ -1,7 +1,6 @@
 import { inject, Injectable } from '@angular/core';
 import { CrmSearchService } from '../services/crm-search.service';
-import { FetchCustomerInput } from '../schemas';
-import { Customer } from '../models';
+import { FetchCustomerInput, Customer } from '../schemas';
 
 @Injectable({ providedIn: 'root' })
 export class CustomerFacade {
diff --git a/libs/crm/data-access/src/lib/models/assigned-payer.ts b/libs/crm/data-access/src/lib/models/assigned-payer.ts
deleted file mode 100644
index 77c075758..000000000
--- a/libs/crm/data-access/src/lib/models/assigned-payer.ts
+++ /dev/null
@@ -1,7 +0,0 @@
-import { AssignedPayerDTO } from '@generated/swagger/crm-api';
-import { Payer } from './payer';
-import { EntityContainer } from '@isa/common/data-access';
-
-export type AssignedPayer = AssignedPayerDTO & {
-  payer: EntityContainer<Payer>;
-};
diff --git a/libs/crm/data-access/src/lib/models/customer.model.ts b/libs/crm/data-access/src/lib/models/customer.model.ts
deleted file mode 100644
index 724b233f8..000000000
--- a/libs/crm/data-access/src/lib/models/customer.model.ts
+++ /dev/null
@@ -1,8 +0,0 @@
-import { CustomerDTO } from '@generated/swagger/crm-api';
-import { CustomerType } from './customer-type';
-import { AssignedPayer } from './assigned-payer';
-
-export interface Customer extends CustomerDTO {
-  customerType: CustomerType;
-  payers: Array<AssignedPayer>;
-}
diff --git a/libs/crm/data-access/src/lib/models/index.ts b/libs/crm/data-access/src/lib/models/index.ts
index 832153a29..dc0170849 100644
--- a/libs/crm/data-access/src/lib/models/index.ts
+++ b/libs/crm/data-access/src/lib/models/index.ts
@@ -1,7 +1,4 @@
-export * from './assigned-payer';
 export * from './bonus-card-info.model';
 export * from './country';
 export * from './customer-type';
-export * from './customer.model';
 export * from './payer';
-export * from './shipping-address.model';
diff --git a/libs/crm/data-access/src/lib/models/shipping-address.model.ts b/libs/crm/data-access/src/lib/models/shipping-address.model.ts
deleted file mode 100644
index a0841926f..000000000
--- a/libs/crm/data-access/src/lib/models/shipping-address.model.ts
+++ /dev/null
@@ -1,3 +0,0 @@
-import { ShippingAddressDTO } from '@generated/swagger/crm-api';
-
-export type ShippingAddress = ShippingAddressDTO;
diff --git a/libs/crm/data-access/src/lib/resources/customer-shipping-address.resource.ts b/libs/crm/data-access/src/lib/resources/customer-shipping-address.resource.ts
index 44d5c34cc..fa68a33db 100644
--- a/libs/crm/data-access/src/lib/resources/customer-shipping-address.resource.ts
+++ b/libs/crm/data-access/src/lib/resources/customer-shipping-address.resource.ts
@@ -1,54 +1,57 @@
-import { effect, inject, Injectable, resource, signal } from '@angular/core';
-import { CrmTabMetadataService, ShippingAddressService } from '../services';
-import { TabService } from '@isa/core/tabs';
-import { ShippingAddress } from '../models';
-
-@Injectable()
-export class CustomerShippingAddressResource {
-  #shippingAddressService = inject(ShippingAddressService);
-
-  #params = signal<{
-    shippingAddressId: number | undefined;
-  }>({
-    shippingAddressId: undefined,
-  });
-
-  params(params: { shippingAddressId?: number }) {
-    this.#params.update((p) => ({ ...p, ...params }));
-  }
-
-  readonly resource = resource({
-    params: () => this.#params(),
-    loader: async ({ params, abortSignal }): Promise<ShippingAddress | undefined> => {
-      if (!params.shippingAddressId) {
-        return undefined;
-      }
-
-      const res = await this.#shippingAddressService.fetchShippingAddress(
-        {
-          shippingAddressId: params.shippingAddressId,
-        },
-        abortSignal,
-      );
-
-      return res.result as ShippingAddress;
-    },
-  });
-}
-
-@Injectable()
-export class SelectedCustomerShippingAddressResource extends CustomerShippingAddressResource {
-  #tabId = inject(TabService).activatedTabId;
-  #customerMetadata = inject(CrmTabMetadataService);
-
-  constructor() {
-    super();
-    effect(() => {
-      const tabId = this.#tabId();
-      const shippingAddressId = tabId
-        ? this.#customerMetadata.selectedShippingAddressId(tabId)
-        : undefined;
-      this.params({ shippingAddressId });
-    });
-  }
-}
+import { effect, inject, Injectable, resource, signal } from '@angular/core';
+import { CrmTabMetadataService, ShippingAddressService } from '../services';
+import { TabService } from '@isa/core/tabs';
+import { ShippingAddress } from '../schemas';
+
+@Injectable()
+export class CustomerShippingAddressResource {
+  #shippingAddressService = inject(ShippingAddressService);
+
+  #params = signal<{
+    shippingAddressId: number | undefined;
+  }>({
+    shippingAddressId: undefined,
+  });
+
+  params(params: { shippingAddressId?: number }) {
+    this.#params.update((p) => ({ ...p, ...params }));
+  }
+
+  readonly resource = resource({
+    params: () => this.#params(),
+    loader: async ({
+      params,
+      abortSignal,
+    }): Promise<ShippingAddress | undefined> => {
+      if (!params.shippingAddressId) {
+        return undefined;
+      }
+
+      const res = await this.#shippingAddressService.fetchShippingAddress(
+        {
+          shippingAddressId: params.shippingAddressId,
+        },
+        abortSignal,
+      );
+
+      return res.result as ShippingAddress;
+    },
+  });
+}
+
+@Injectable()
+export class SelectedCustomerShippingAddressResource extends CustomerShippingAddressResource {
+  #tabId = inject(TabService).activatedTabId;
+  #customerMetadata = inject(CrmTabMetadataService);
+
+  constructor() {
+    super();
+    effect(() => {
+      const tabId = this.#tabId();
+      const shippingAddressId = tabId
+        ? this.#customerMetadata.selectedShippingAddressId(tabId)
+        : undefined;
+      this.params({ shippingAddressId });
+    });
+  }
+}
diff --git a/libs/crm/data-access/src/lib/resources/customer-shipping-addresses.resource.ts b/libs/crm/data-access/src/lib/resources/customer-shipping-addresses.resource.ts
index a04d1ed7e..f9074a3ae 100644
--- a/libs/crm/data-access/src/lib/resources/customer-shipping-addresses.resource.ts
+++ b/libs/crm/data-access/src/lib/resources/customer-shipping-addresses.resource.ts
@@ -1,58 +1,66 @@
-import { effect, inject, Injectable, resource, signal } from '@angular/core';
-import { CrmTabMetadataService, ShippingAddressService } from '../services';
-import { TabService } from '@isa/core/tabs';
-import { ShippingAddress } from '../models';
-
-@Injectable()
-export class CustomerShippingAddressesResource {
-  #shippingAddressService = inject(ShippingAddressService);
-
-  #params = signal<{
-    customerId: number | undefined;
-    take?: number | null;
-    skip?: number | null;
-  }>({
-    customerId: undefined,
-  });
-
-  params(params: { customerId?: number; take?: number | null; skip?: number | null }) {
-    this.#params.update((p) => ({ ...p, ...params }));
-  }
-
-  readonly resource = resource({
-    params: () => this.#params(),
-    loader: async ({ params, abortSignal }): Promise<ShippingAddress[] | undefined> => {
-      if (!params.customerId) {
-        return undefined;
-      }
-
-      const res = await this.#shippingAddressService.fetchCustomerShippingAddresses(
-        {
-          customerId: params.customerId,
-          take: params.take,
-          skip: params.skip,
-        },
-        abortSignal,
-      );
-
-      return res.result as ShippingAddress[];
-    },
-  });
-}
-
-@Injectable()
-export class SelectedCustomerShippingAddressesResource extends CustomerShippingAddressesResource {
-  #tabId = inject(TabService).activatedTabId;
-  #customerMetadata = inject(CrmTabMetadataService);
-
-  constructor() {
-    super();
-    effect(() => {
-      const tabId = this.#tabId();
-      const customerId = tabId
-        ? this.#customerMetadata.selectedCustomerId(tabId)
-        : undefined;
-      this.params({ customerId });
-    });
-  }
-}
+import { effect, inject, Injectable, resource, signal } from '@angular/core';
+import { CrmTabMetadataService, ShippingAddressService } from '../services';
+import { TabService } from '@isa/core/tabs';
+import { ShippingAddress } from '../schemas';
+
+@Injectable()
+export class CustomerShippingAddressesResource {
+  #shippingAddressService = inject(ShippingAddressService);
+
+  #params = signal<{
+    customerId: number | undefined;
+    take?: number | null;
+    skip?: number | null;
+  }>({
+    customerId: undefined,
+  });
+
+  params(params: {
+    customerId?: number;
+    take?: number | null;
+    skip?: number | null;
+  }) {
+    this.#params.update((p) => ({ ...p, ...params }));
+  }
+
+  readonly resource = resource({
+    params: () => this.#params(),
+    loader: async ({
+      params,
+      abortSignal,
+    }): Promise<ShippingAddress[] | undefined> => {
+      if (!params.customerId) {
+        return undefined;
+      }
+
+      const res =
+        await this.#shippingAddressService.fetchCustomerShippingAddresses(
+          {
+            customerId: params.customerId,
+            take: params.take,
+            skip: params.skip,
+          },
+          abortSignal,
+        );
+
+      return res.result as ShippingAddress[];
+    },
+  });
+}
+
+@Injectable()
+export class SelectedCustomerShippingAddressesResource extends CustomerShippingAddressesResource {
+  #tabId = inject(TabService).activatedTabId;
+  #customerMetadata = inject(CrmTabMetadataService);
+
+  constructor() {
+    super();
+    effect(() => {
+      const tabId = this.#tabId();
+      const customerId = tabId
+        ? this.#customerMetadata.selectedCustomerId(tabId)
+        : undefined;
+      this.params({ customerId });
+    });
+  }
+}
diff --git a/libs/crm/data-access/src/lib/resources/customer.resource.ts b/libs/crm/data-access/src/lib/resources/customer.resource.ts
index 351eac74e..59daa3729 100644
--- a/libs/crm/data-access/src/lib/resources/customer.resource.ts
+++ b/libs/crm/data-access/src/lib/resources/customer.resource.ts
@@ -1,7 +1,7 @@
 import { effect, inject, Injectable, resource, signal } from '@angular/core';
 import { CrmSearchService, CrmTabMetadataService } from '../services';
 import { TabService } from '@isa/core/tabs';
-import { Customer } from '../models';
+import { Customer } from '../schemas';
 
 @Injectable()
 export class CustomerResource {
diff --git a/libs/crm/data-access/src/lib/schemas/assigned-payer.schema.ts b/libs/crm/data-access/src/lib/schemas/assigned-payer.schema.ts
new file mode 100644
index 000000000..f0458ac00
--- /dev/null
+++ b/libs/crm/data-access/src/lib/schemas/assigned-payer.schema.ts
@@ -0,0 +1,11 @@
+import { EntityContainerSchema } from '@isa/common/data-access';
+import { z } from 'zod';
+import { PayerSchema } from './payer.schema';
+
+export const AssignedPayerSchema = z.object({
+  assignedToCustomer: z.string().describe('Assigned to customer').optional(),
+  isDefault: z.string().describe('Whether this is the default').optional(),
+  payer: EntityContainerSchema(PayerSchema).describe('Payer information').optional(),
+});
+
+export type AssignedPayer = z.infer<typeof AssignedPayerSchema>;
diff --git a/libs/crm/data-access/src/lib/schemas/attribute.schema.ts b/libs/crm/data-access/src/lib/schemas/attribute.schema.ts
new file mode 100644
index 000000000..856e2a31e
--- /dev/null
+++ b/libs/crm/data-access/src/lib/schemas/attribute.schema.ts
@@ -0,0 +1,19 @@
+import { z } from 'zod';
+
+/**
+ * Schema for AttributeDTO
+ * Represents attribute data with date fields as strings (ISO format)
+ *
+ * Note: The API returns start/stop as string (not Date objects).
+ * If date parsing is needed, use z.coerce.date() or parse in application logic.
+ */
+export const AttributeSchema = z.object({
+  dataType: z.number().describe('Data type'),
+  formatValidator: z.string().describe('Format validator').optional(),
+  group: z.string().describe('Group').optional(),
+  key: z.string().describe('Key'),
+  name: z.string().describe('Name').optional(),
+  start: z.string().describe('Start').optional(),
+  stop: z.string().describe('Stop').optional(),
+  value: z.string().describe('Value').optional(),
+});
diff --git a/libs/crm/data-access/src/lib/schemas/bonus-card.schema.ts b/libs/crm/data-access/src/lib/schemas/bonus-card.schema.ts
new file mode 100644
index 000000000..9c95772d8
--- /dev/null
+++ b/libs/crm/data-access/src/lib/schemas/bonus-card.schema.ts
@@ -0,0 +1,22 @@
+import { EntitySchema } from '@isa/common/data-access';
+import { z } from 'zod';
+
+/**
+ * Schema for BonusCardDTO
+ * Represents bonus card information with proper type matching
+ *
+ * Note: cardProvider is a number in the API, and dates are returned as strings
+ */
+export const BonusCardSchema = z
+  .object({
+    bonusValue: z.number().describe('Bonus value').optional(),
+    cardNumber: z.string().describe('Card number').optional(),
+    cardProvider: z.number().describe('Card provider').optional(),
+    isLocked: z.boolean().describe('Whether locked').optional(),
+    isPaymentEnabled: z.boolean().describe('Whether paymentEnabled').optional(),
+    markedAsLost: z.string().describe('Marked as lost').optional(),
+    suspensionComment: z.string().describe('Suspension comment').optional(),
+    validFrom: z.string().describe('Validity start date').optional(),
+    validThrough: z.string().describe('Valid through').optional(),
+  })
+  .extend(EntitySchema.shape);
diff --git a/libs/crm/data-access/src/lib/schemas/branch.schema.ts b/libs/crm/data-access/src/lib/schemas/branch.schema.ts
new file mode 100644
index 000000000..049cad9a5
--- /dev/null
+++ b/libs/crm/data-access/src/lib/schemas/branch.schema.ts
@@ -0,0 +1,21 @@
+import {
+  AddressSchema,
+  EntityContainerSchema,
+  EntitySchema,
+  LabelSchema,
+} from '@isa/common/data-access';
+import { number, z } from 'zod';
+
+export const BranchSchema = z
+  .object({
+    address: AddressSchema.describe('Address').optional(),
+    banchNumber: z.string().describe('Banch number').optional(),
+    branchType: z.number().describe('Branch type'),
+    isOnline: z.boolean().describe('Whether online').optional(),
+    key: z.string().describe('Key').optional(),
+    label: EntityContainerSchema(LabelSchema).describe('Label').optional(),
+    name: z.string().describe('Name').optional(),
+    parent: z.number().describe('Parent').optional(),
+    shortName: z.string().describe('Short name').optional(),
+  })
+  .extend(EntitySchema.shape);
diff --git a/libs/crm/data-access/src/lib/schemas/customer.schema.ts b/libs/crm/data-access/src/lib/schemas/customer.schema.ts
new file mode 100644
index 000000000..052d0d6d7
--- /dev/null
+++ b/libs/crm/data-access/src/lib/schemas/customer.schema.ts
@@ -0,0 +1,96 @@
+import {
+  AddressSchema,
+  CommunicationDetailsSchema,
+  EntityContainerSchema,
+  EntitySchema,
+  GenderSchema,
+  KeyValueOfStringAndStringSchema,
+  LabelSchema,
+  NotificationChannelSchema,
+  OrganisationSchema,
+} from '@isa/common/data-access';
+import { z } from 'zod';
+import { CustomerType } from '../models';
+import { AssignedPayerSchema } from './assigned-payer.schema';
+import { AttributeSchema } from './attribute.schema';
+import { BonusCardSchema } from './bonus-card.schema';
+import { BranchSchema } from './branch.schema';
+import { LinkedRecordSchema } from './linked-record.schema';
+import { ShippingAddressSchema } from './shipping-address.schema';
+import { UserSchema } from './user.schema';
+
+export const CustomerSchema = z
+  .object({
+    address: AddressSchema.describe('Address').optional(),
+    agentComment: z.string().describe('Agent comment').optional(),
+    attributes: z
+      .array(EntityContainerSchema(AttributeSchema))
+      .describe('Attribute list')
+      .optional(),
+    bonusCard: EntityContainerSchema(BonusCardSchema)
+      .describe('Bonus card information')
+      .optional(),
+    campaignCode: z.string().describe('Campaign code').optional(),
+    clientChannel: z.number().describe('Client channel').optional(),
+    communicationDetails: CommunicationDetailsSchema.describe(
+      'Communication details',
+    ).optional(),
+    createdInBranch: EntityContainerSchema(BranchSchema)
+      .describe('Created in branch')
+      .optional(),
+    customerGroup: z.string().describe('Customer group').optional(),
+    customerNumber: z.string().describe('Customer number').optional(),
+    customerStatus: z.number().describe('Customer status').optional(),
+    customerType: z.nativeEnum(CustomerType).describe('Customer type'),
+    dateOfBirth: z.string().describe('Date of birth').optional(),
+    deactivationComment: z.string().describe('Deactivation comment').optional(),
+    features: z
+      .array(KeyValueOfStringAndStringSchema)
+      .describe('Features')
+      .optional(),
+    fetchOnDeliveryNote: z
+      .boolean()
+      .describe('Fetch on delivery note')
+      .optional(),
+    firstName: z.string().describe('First name').optional(),
+    gender: GenderSchema.describe('Gender').optional(),
+    hasOnlineAccount: z
+      .boolean()
+      .describe('Whether has onlineAccount')
+      .optional(),
+    isGuestAccount: z.boolean().describe('Whether guestAccount').optional(),
+    label: EntityContainerSchema(LabelSchema).describe('Label').optional(),
+    lastName: z.string().describe('Last name').optional(),
+    linkedRecords: z
+      .array(LinkedRecordSchema)
+      .describe('List of linked records')
+      .optional(),
+    notificationChannels: NotificationChannelSchema.describe(
+      'Notification channels',
+    ).optional(),
+    orderCount: z.number().describe('Number of orders').optional(),
+    organisation: OrganisationSchema.describe(
+      'Organisation information',
+    ).optional(),
+    payers: z.array(AssignedPayerSchema).describe('Payers').optional(),
+    preferredPaymentType: z
+      .number()
+      .describe('PreferredPayment type')
+      .optional(),
+    shippingAddresses: z
+      .array(EntityContainerSchema(ShippingAddressSchema))
+      .describe('Shipping addresses')
+      .optional(),
+    statusChangeComment: z
+      .string()
+      .describe('Status change comment')
+      .optional(),
+    statusComment: z.string().describe('Status comment').optional(),
+    title: z.string().describe('Title').optional(),
+    user: EntityContainerSchema(UserSchema)
+      .describe('User information')
+      .optional(),
+  })
+  .extend(EntitySchema.shape);
+
+export type Customer = z.infer<typeof CustomerSchema>;
diff --git a/libs/crm/data-access/src/lib/schemas/fetch-customer-cards.schema.ts b/libs/crm/data-access/src/lib/schemas/fetch-customer-cards.schema.ts
index 0f136cc77..b343b5a43 100644
--- a/libs/crm/data-access/src/lib/schemas/fetch-customer-cards.schema.ts
+++ b/libs/crm/data-access/src/lib/schemas/fetch-customer-cards.schema.ts
@@ -1,7 +1,7 @@
 import { z } from 'zod';
 
 export const FetchCustomerCardsSchema = z.object({
-  customerId: z.number().int(),
+  customerId: z.number().int().describe('Unique customer identifier'),
 });
 
 export type FetchCustomerCards = z.infer<typeof FetchCustomerCardsSchema>;
diff --git a/libs/crm/data-access/src/lib/schemas/fetch-customer-shipping-addresses.schema.ts b/libs/crm/data-access/src/lib/schemas/fetch-customer-shipping-addresses.schema.ts
index f8dfa2445..77cab4d79 100644
--- a/libs/crm/data-access/src/lib/schemas/fetch-customer-shipping-addresses.schema.ts
+++ b/libs/crm/data-access/src/lib/schemas/fetch-customer-shipping-addresses.schema.ts
@@ -1,9 +1,9 @@
 import { z } from 'zod';
 
 export const FetchCustomerShippingAddressesSchema = z.object({
-  customerId: z.number().int(),
-  take: z.number().int().optional().nullable(),
-  skip: z.number().int().optional().nullable(),
+  customerId: z.number().int().describe('Unique customer identifier'),
+  take: z.number().int().optional().describe('Number of items to return per page').nullable(),
+  skip: z.number().int().optional().describe('Number of items to skip for pagination').nullable(),
 });
 
 export type FetchCustomerShippingAddresses = z.infer<typeof FetchCustomerShippingAddressesSchema>;
diff --git a/libs/crm/data-access/src/lib/schemas/fetch-customer.schema.ts b/libs/crm/data-access/src/lib/schemas/fetch-customer.schema.ts
index 3fd60868a..cc27414e9 100644
--- a/libs/crm/data-access/src/lib/schemas/fetch-customer.schema.ts
+++ b/libs/crm/data-access/src/lib/schemas/fetch-customer.schema.ts
@@ -1,8 +1,8 @@
 import { z } from 'zod';
 
 export const FetchCustomerSchema = z.object({
-  customerId: z.number().int(),
-  eagerLoading: z.number().optional(),
+  customerId: z.number().int().describe('Unique customer identifier'),
+  eagerLoading: z.number().describe('Eager loading').optional(),
 });
 
 export type FetchCustomer = z.infer<typeof FetchCustomerSchema>;
diff --git a/libs/crm/data-access/src/lib/schemas/fetch-shipping-address.schema.ts b/libs/crm/data-access/src/lib/schemas/fetch-shipping-address.schema.ts
index 8f34ef34e..64d7a3bf1 100644
--- a/libs/crm/data-access/src/lib/schemas/fetch-shipping-address.schema.ts
+++ b/libs/crm/data-access/src/lib/schemas/fetch-shipping-address.schema.ts
@@ -1,7 +1,7 @@
 import { z } from 'zod';
 
 export const FetchShippingAddressSchema = z.object({
-  shippingAddressId: z.number().int(),
+  shippingAddressId: z.number().int().describe('ShippingAddress identifier'),
 });
 
 export type FetchShippingAddress = z.infer<typeof FetchShippingAddressSchema>;
diff --git a/libs/crm/data-access/src/lib/schemas/index.ts b/libs/crm/data-access/src/lib/schemas/index.ts
index 3d0c1d901..122a5e226 100644
--- a/libs/crm/data-access/src/lib/schemas/index.ts
+++ b/libs/crm/data-access/src/lib/schemas/index.ts
@@ -1,4 +1,16 @@
-export * from './fetch-customer-cards.schema';
-export * from './fetch-customer-shipping-addresses.schema';
-export * from './fetch-customer.schema';
-export * from './fetch-shipping-address.schema';
+export * from './assigned-payer.schema';
+export * from './attribute.schema';
+export * from './bonus-card.schema';
+export * from './branch.schema';
+export * from './customer.schema';
+export * from './fetch-customer-cards.schema';
+export * from './fetch-customer-shipping-addresses.schema';
+export * from './fetch-customer.schema';
+export * from './fetch-shipping-address.schema';
+export * from './linked-record.schema';
+export * from './notification-channel.schema';
+export * from './payer-status.schema';
+export * from './payer.schema';
+export * from './payment-settings.schema';
+export * from './shipping-address.schema';
+export * from './user.schema';
diff --git a/libs/crm/data-access/src/lib/schemas/linked-record.schema.ts b/libs/crm/data-access/src/lib/schemas/linked-record.schema.ts
new file mode 100644
index 000000000..483754cfa
--- /dev/null
+++ b/libs/crm/data-access/src/lib/schemas/linked-record.schema.ts
@@ -0,0 +1,8 @@
+import { z } from 'zod';
+
+export const LinkedRecordSchema = z.object({
+  isSource: z.boolean().describe('Whether source').optional(),
+  number: z.string().describe('Number').optional(),
+  pk: z.string().describe('Pk').optional(),
+  repository: z.string().describe('Repository').optional(),
+});
diff --git a/libs/crm/data-access/src/lib/schemas/notification-channel.schema.ts b/libs/crm/data-access/src/lib/schemas/notification-channel.schema.ts
new file mode 100644
index 000000000..1d923b60b
--- /dev/null
+++ b/libs/crm/data-access/src/lib/schemas/notification-channel.schema.ts
@@ -0,0 +1,11 @@
+/**
+ * @deprecated This schema has been moved to @isa/common/data-access.
+ * Please update imports to use:
+ * import { NotificationChannelSchema, NotificationChannel } from '@isa/common/data-access';
+ *
+ * This re-export will be removed in a future version.
+ */
+export {
+  NotificationChannelSchema,
+  NotificationChannel,
+} from '@isa/common/data-access';
diff --git a/libs/crm/data-access/src/lib/schemas/payer-status.schema.ts b/libs/crm/data-access/src/lib/schemas/payer-status.schema.ts
new file mode 100644
index 000000000..62afd9096
--- /dev/null
+++ b/libs/crm/data-access/src/lib/schemas/payer-status.schema.ts
@@ -0,0 +1,14 @@
+import { z } from 'zod';
+
+export const PayerStatus = {
+  NotSet: 0,
+  Blocked: 1,
+  Check: 2,
+  LowDegreeOfCreditworthiness: 4,
+  Dunning1: 8,
+  Dunning2: 16,
+} as const;
+
+export const PayerStatusSchema = z.nativeEnum(PayerStatus).describe('Payer status');
+
+export type PayerStatus = z.infer<typeof PayerStatusSchema>;
diff --git a/libs/crm/data-access/src/lib/schemas/payer.schema.ts b/libs/crm/data-access/src/lib/schemas/payer.schema.ts
new file mode 100644
index 000000000..86f9d1012
--- /dev/null
+++ b/libs/crm/data-access/src/lib/schemas/payer.schema.ts
@@ -0,0 +1,38 @@
+import {
+  AddressSchema,
+  CommunicationDetailsSchema,
+  EntityContainerSchema,
+  EntitySchema,
+  GenderSchema,
+  LabelSchema,
+  OrganisationSchema,
+  PayerType,
+} from '@isa/common/data-access';
+import { z } from 'zod';
+import { PayerStatusSchema } from './payer-status.schema';
+import { PaymentSettingsSchema } from './payment-settings.schema';
+
+export const PayerSchema = z
+  .object({
+    address: AddressSchema.describe('Address').optional(),
+    agentComment: z.string().describe('Agent comment').optional(),
+    communicationDetails: CommunicationDetailsSchema.describe('Communication details').optional(),
+    deactivationComment: z.string().describe('Deactivation comment').optional(),
+    defaultPaymentPeriod: z.number().describe('Default payment period').optional(),
+    firstName: z.string().describe('First name').optional(),
+    gender: GenderSchema.describe('Gender').optional(),
+    isGuestAccount: z.boolean().describe('Whether guestAccount').optional(),
+    label: EntityContainerSchema(LabelSchema).describe('Label').optional(),
+    lastName: z.string().describe('Last name').optional(),
+    organisation: OrganisationSchema.describe('Organisation information').optional(),
+    payerGroup: z.string().describe('Payer group').optional(),
+    payerNumber: z.string().describe('Unique payer account number').optional(),
+    payerStatus: PayerStatusSchema.describe('Current status of the payer account').optional(),
+    payerType: z.nativeEnum(PayerType).describe('Payer type').optional(),
+    paymentTypes: z.array(PaymentSettingsSchema).describe('Payment types').optional(),
+    standardInvoiceText: z.string().describe('Standard invoice text').optional(),
+    statusChangeComment: z.string().describe('Status change comment').optional(),
+    statusComment: z.string().describe('Status comment').optional(),
+    title: z.string().describe('Title').optional(),
+  })
+  .extend(EntitySchema.shape);
diff --git a/libs/crm/data-access/src/lib/schemas/payment-settings.schema.ts b/libs/crm/data-access/src/lib/schemas/payment-settings.schema.ts
new file mode 100644
index 000000000..ae09305fa
--- /dev/null
+++ b/libs/crm/data-access/src/lib/schemas/payment-settings.schema.ts
@@ -0,0 +1,9 @@
+import { z } from 'zod';
+
+export const PaymentSettingsSchema = z.object({
+  allow: z.string().describe('Allow').optional(),
+  channel: z.string().describe('Communication channel').optional(),
+  denaiedReason: z.string().describe('Denaied reason').optional(),
+  deny: z.string().describe('Deny').optional(),
+  paymentType: z.number().int().positive().describe('Payment type').optional(),
+});
diff --git a/libs/crm/data-access/src/lib/schemas/shipping-address.schema.ts b/libs/crm/data-access/src/lib/schemas/shipping-address.schema.ts
new file mode 100644
index 000000000..3cf16229c
--- /dev/null
+++ b/libs/crm/data-access/src/lib/schemas/shipping-address.schema.ts
@@ -0,0 +1,26 @@
+import {
+  AddressSchema,
+  CommunicationDetailsSchema,
+  EntitySchema,
+  GenderSchema,
+  OrganisationSchema,
+} from '@isa/common/data-access';
+import z from 'zod';
+
+export const ShippingAddressSchema = z
+  .object({
+    address: AddressSchema.describe('Address').optional(),
+    agentomment: z.string().describe('Agentomment').optional(),
+    communicationDetails: CommunicationDetailsSchema.describe('Communication details').optional(),
+    firstName: z.string().describe('First name').optional(),
+    gender: GenderSchema.describe('Gender').optional(),
+    lastName: z.string().describe('Last name').optional(),
+    organisation: OrganisationSchema.describe('Organisation information').optional(),
+    title: z.string().describe('Title').optional(),
+    type: z.number().describe('Type').optional(),
+    validated: z.string().describe('Validated').optional(),
+    validationResult: z.number().describe('Validation result').optional(),
+  })
+  .extend(EntitySchema.shape);
+
+export type ShippingAddress = z.infer<typeof ShippingAddressSchema>;
diff --git a/libs/crm/data-access/src/lib/schemas/user.schema.ts b/libs/crm/data-access/src/lib/schemas/user.schema.ts
new file mode 100644
index 000000000..65135fc9a
--- /dev/null
+++ b/libs/crm/data-access/src/lib/schemas/user.schema.ts
@@ -0,0 +1,13 @@
+import { EntitySchema, GenderSchema } from '@isa/common/data-access';
+import { z } from 'zod';
+
+export const UserSchema = z
+  .object({
+    email: z.string().email().describe('Email address').optional(),
+    firstName: z.string().describe('First name').optional(),
+    gender: GenderSchema.describe('Gender').optional(),
+    lastName: z.string().describe('Last name').optional(),
+    name: z.string().describe('Name').optional(),
+    title: z.string().describe('Title').optional(),
+  })
+  .extend(EntitySchema.shape);
diff --git a/libs/crm/data-access/src/lib/services/crm-search.service.ts b/libs/crm/data-access/src/lib/services/crm-search.service.ts
index b36549bbe..e393d70ad 100644
--- a/libs/crm/data-access/src/lib/services/crm-search.service.ts
+++ b/libs/crm/data-access/src/lib/services/crm-search.service.ts
@@ -1,6 +1,7 @@
 import { inject, Injectable } from '@angular/core';
 import { CustomerService } from '@generated/swagger/crm-api';
 import {
+  Customer,
   FetchCustomerCardsInput,
   FetchCustomerCardsSchema,
   FetchCustomerInput,
@@ -12,7 +13,7 @@ import {
   takeUntilAborted,
 } from '@isa/common/data-access';
 import { firstValueFrom } from 'rxjs';
-import { BonusCardInfo, Customer } from '../models';
+import { BonusCardInfo } from '../models';
 import { logger } from '@isa/core/logging';
 
 @Injectable({ providedIn: 'root' })
diff --git a/libs/crm/data-access/src/lib/services/shipping-address.service.ts b/libs/crm/data-access/src/lib/services/shipping-address.service.ts
index d3bcdc762..84312f7fa 100644
--- a/libs/crm/data-access/src/lib/services/shipping-address.service.ts
+++ b/libs/crm/data-access/src/lib/services/shipping-address.service.ts
@@ -1,79 +1,79 @@
-import { inject, Injectable } from '@angular/core';
-import { ShippingAddressService as GeneratedShippingAddressService } from '@generated/swagger/crm-api';
-import {
-  FetchCustomerShippingAddressesInput,
-  FetchCustomerShippingAddressesSchema,
-  FetchShippingAddressInput,
-  FetchShippingAddressSchema,
-} from '../schemas';
-import {
-  catchResponseArgsErrorPipe,
-  ListResponseArgs,
-  ResponseArgs,
-  takeUntilAborted,
-} from '@isa/common/data-access';
-import { firstValueFrom } from 'rxjs';
-import { ShippingAddress } from '../models';
-import { logger } from '@isa/core/logging';
-
-@Injectable({ providedIn: 'root' })
-export class ShippingAddressService {
-  #shippingAddressService = inject(GeneratedShippingAddressService);
-  #logger = logger(() => ({
-    service: 'ShippingAddressService',
-  }));
-
-  async fetchCustomerShippingAddresses(
-    params: FetchCustomerShippingAddressesInput,
-    abortSignal?: AbortSignal,
-  ): Promise<ListResponseArgs<ShippingAddress>> {
-    this.#logger.info('Fetching customer shipping addresses from API');
-    const { customerId, take, skip } =
-      FetchCustomerShippingAddressesSchema.parse(params);
-
-    let req$ = this.#shippingAddressService
-      .ShippingAddressGetShippingAddresses({ customerId, take, skip })
-      .pipe(catchResponseArgsErrorPipe());
-
-    if (abortSignal) {
-      req$ = req$.pipe(takeUntilAborted(abortSignal));
-    }
-
-    try {
-      const res = await firstValueFrom(req$);
-      this.#logger.debug('Successfully fetched customer shipping addresses');
-      return res as ListResponseArgs<ShippingAddress>;
-    } catch (error) {
-      this.#logger.error('Error fetching customer shipping addresses', error);
-      return {
-        result: [],
-        totalCount: 0,
-      } as unknown as ListResponseArgs<ShippingAddress>;
-    }
-  }
-
-  async fetchShippingAddress(
-    params: FetchShippingAddressInput,
-    abortSignal?: AbortSignal,
-  ): Promise<ResponseArgs<ShippingAddress>> {
-    this.#logger.info('Fetching shipping address from API');
-    const { shippingAddressId } = FetchShippingAddressSchema.parse(params);
-
-    let req$ = this.#shippingAddressService
-      .ShippingAddressGetShippingaddress(shippingAddressId)
-      .pipe(catchResponseArgsErrorPipe());
-
-    if (abortSignal) {
-      req$ = req$.pipe(takeUntilAborted(abortSignal));
-    }
-
-    try {
-      const res = await firstValueFrom(req$);
-      this.#logger.debug('Successfully fetched shipping address');
-      return res as ResponseArgs<ShippingAddress>;
-    } catch (error) {
-      this.#logger.error('Error fetching shipping address', error);
-      return undefined as unknown as ResponseArgs<ShippingAddress>;
-    }
-  }
-}
+import { inject, Injectable } from '@angular/core';
+import { ShippingAddressService as GeneratedShippingAddressService } from '@generated/swagger/crm-api';
+import {
+  FetchCustomerShippingAddressesInput,
+  FetchCustomerShippingAddressesSchema,
+  FetchShippingAddressInput,
+  FetchShippingAddressSchema,
+  ShippingAddress,
+} from '../schemas';
+import {
+  catchResponseArgsErrorPipe,
+  ListResponseArgs,
+  ResponseArgs,
+  takeUntilAborted,
+} from '@isa/common/data-access';
+import { firstValueFrom } from 'rxjs';
+import { logger } from '@isa/core/logging';
+
+@Injectable({ providedIn: 'root' })
+export class ShippingAddressService {
+  #shippingAddressService = inject(GeneratedShippingAddressService);
+  #logger = logger(() => ({
+    service: 'ShippingAddressService',
+  }));
+
+  async fetchCustomerShippingAddresses(
+    params: FetchCustomerShippingAddressesInput,
+    abortSignal?: AbortSignal,
+  ): Promise<ListResponseArgs<ShippingAddress>> {
+    this.#logger.info('Fetching customer shipping addresses from API');
+    const { customerId, take, skip } =
+      FetchCustomerShippingAddressesSchema.parse(params);
+
+    let req$ = this.#shippingAddressService
+      .ShippingAddressGetShippingAddresses({ customerId, take, skip })
+      .pipe(catchResponseArgsErrorPipe());
+
+    if (abortSignal) {
+      req$ = req$.pipe(takeUntilAborted(abortSignal));
+    }
+
+    try {
+      const res = await firstValueFrom(req$);
+      this.#logger.debug('Successfully fetched customer shipping addresses');
+      return res as ListResponseArgs<ShippingAddress>;
+    } catch (error) {
+      this.#logger.error('Error fetching customer shipping addresses', error);
+      return {
+        result: [],
+        totalCount: 0,
+      } as unknown as ListResponseArgs<ShippingAddress>;
+    }
+  }
+
+  async fetchShippingAddress(
+    params: FetchShippingAddressInput,
+    abortSignal?: AbortSignal,
+  ): Promise<ResponseArgs<ShippingAddress>> {
+    this.#logger.info('Fetching shipping address from API');
+    const { shippingAddressId } = FetchShippingAddressSchema.parse(params);
+
+    let req$ = this.#shippingAddressService
+      .ShippingAddressGetShippingaddress(shippingAddressId)
+      .pipe(catchResponseArgsErrorPipe());
+
+    if (abortSignal) {
+      req$ = req$.pipe(takeUntilAborted(abortSignal));
+    }
+
+    try {
+      const res = await firstValueFrom(req$);
+      this.#logger.debug('Successfully fetched shipping address');
+      return res as ResponseArgs<ShippingAddress>;
+    } catch (error) {
+      this.#logger.error('Error fetching shipping address', error);
+      return undefined as unknown as ResponseArgs<ShippingAddress>;
+    }
+  }
+}
diff --git a/libs/oms/data-access/README.md b/libs/oms/data-access/README.md
index 1cf4c826d..3c4317785 100644
--- a/libs/oms/data-access/README.md
+++ b/libs/oms/data-access/README.md
@@ -1,7 +1,843 @@
-# oms-data-access
+# @isa/oms/data-access
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive Order Management System (OMS) data access library for Angular applications providing return processing, receipt management, order creation, and print capabilities.
 
-## Running unit tests
+## Overview
 
-Run `nx test oms-data-access` to execute the unit tests.
+The OMS Data Access library provides a complete suite of services, stores, and utilities for managing the entire return lifecycle in a retail environment. It integrates with the generated OMS API client and provides intelligent state management, question-based return workflows, validation, and receipt printing capabilities. The library follows domain-driven design principles with clear separation between business logic, state management, and API integration.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Return Process Workflow](#return-process-workflow)
+- [Product Categories and Questions](#product-categories-and-questions)
+- [State Management](#state-management)
+- [Error Handling](#error-handling)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Return Search** - Advanced receipt search with query builder and filter support
+- **Return Process Management** - Question-based return workflow with branching logic
+- **Product Category System** - Category-specific questions and validation rules
+- **Receipt Management** - Full CRUD operations for receipts and receipt items
+- **Order Creation** - Create orders from completed checkouts
+- **Print Integration** - Automated return receipt printing via label printers
+- **NgRx Signals Stores** - Reactive state management with persistence
+- **Session & IndexedDB Storage** - Automatic state persistence across browser sessions
+- **Orphaned Entity Cleanup** - Automatic cleanup when tabs are closed
+- **Zod Schema Validation** - Runtime validation for all data structures
+- **AbortSignal Support** - Request cancellation for all async operations
+- **Comprehensive Logging** - Integration with @isa/core/logging for debugging
+- **Question Branching Logic** - Dynamic question flow based on previous answers
+
+## Quick Start
+
+### 1. Import and Inject Services
+
+```typescript
+import { Component, inject } from '@angular/core';
+import {
+  ReturnSearchService,
+  ReturnDetailsService,
+  ReturnProcessService
+} from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-return-management',
+  template: '...'
+})
+export class ReturnManagementComponent {
+  #returnSearchService = inject(ReturnSearchService);
+  #returnDetailsService = inject(ReturnDetailsService);
+  #returnProcessService = inject(ReturnProcessService);
+}
+```
+
+### 2. Search for Receipts
+
+```typescript
+async searchReceipts(): Promise<void> {
+  const results = await firstValueFrom(
+    this.#returnSearchService.search({
+      input: { qs: '12345' },  // Receipt number or search term
+      filter: { receipt_type: '1;128;1024' },
+      take: 20,
+      skip: 0
+    })
+  );
+
+  console.log(`Found ${results.hits} receipts`);
+  results.result.forEach(receipt => {
+    console.log(`Receipt #${receipt.receiptNumber}: ${receipt.date}`);
+  });
+}
+```
+
+### 3. Fetch Receipt Details
+
+```typescript
+async getReceiptDetails(receiptId: number): Promise<void> {
+  const receipt = await this.#returnDetailsService.fetchReturnDetails({
+    receiptId: receiptId
+  });
+
+  console.log(`Receipt: ${receipt.receiptNumber}`);
+  console.log(`Buyer: ${receipt.buyer.firstName} ${receipt.buyer.lastName}`);
+  console.log(`Items: ${receipt.items.length}`);
+}
+```
+
+### 4. Process a Return
+
+```typescript
+async processReturn(): Promise<void> {
+  // Start a return process
+  const returnProcess: ReturnProcess = {
+    id: 1,
+    processId: 100,
+    receiptId: 12345,
+    receiptItem: receiptItem,
+    receiptDate: '2025-10-20',
+    answers: {},
+    productCategory: ProductCategory.ElektronischeGeraete,
+    quantity: 1
+  };
+
+  // Get active questions
+  const questions = this.#returnProcessService.activeReturnProcessQuestions(returnProcess);
+
+  // Check eligibility
+  const eligibility = this.#returnProcessService.eligibleForReturn(returnProcess);
+  if (eligibility?.state === EligibleForReturnState.Eligible) {
+    console.log('Item is eligible for return');
+  }
+}
+```
+
+## Core Concepts
+
+### Return Process Lifecycle
+
+The return process follows a structured workflow:
+
+```
+1. Search & Selection
+   └─> Search for receipts using ReturnSearchService
+   └─> Select receipt items to return
+
+2. Return Process Initialization
+   └─> Create ReturnProcess entities via ReturnProcessStore
+   └─> Assign product categories to items
+
+3. Question Workflow
+   └─> Display category-specific questions
+   └─> Collect answers with validation
+   └─> Follow branching logic based on answers
+
+4. Eligibility Determination
+   └─> Validate all questions answered
+   └─> Check category-specific business rules
+   └─> Determine if item is eligible for return
+
+5. Completion
+   └─> Generate return receipts via ReceiptService
+   └─> Print return receipts via PrintReceiptsService
+   └─> Update process with return receipt
+```
+
+### Product Categories
+
+The library supports seven product categories, each with specific return rules:
+
+```typescript
+enum ProductCategory {
+  BookCalendar = 'book-calendar',           // Books and calendars
+  TonDatentraeger = 'ton-datentraeger',     // Audio and data media
+  SpielwarenPuzzle = 'spielwaren-puzzle',   // Toys and puzzles
+  SonstigesNonbook = 'sonstiges-nonbook',   // Other non-book items
+  ElektronischeGeraete = 'elektronische-geraete',  // Electronic devices
+  Tolino = 'tolino',                        // Tolino e-readers
+  Unknown = 'unknown'                       // Uncategorized
+}
+```
+
+Each category has:
+- **Specific questions** - Defined in the CategoryQuestions registry
+- **Branching logic** - Questions can have nextQuestion properties
+- **Validation rules** - Category-specific eligibility checks
+- **Business rules** - Special handling (e.g., sealed packages, electronic devices)
+
+### Question System Architecture
+
+Questions follow a tree-like structure with branching:
+
+```typescript
+interface ReturnProcessQuestion {
+  key: string;                          // Unique question identifier
+  type: ReturnProcessQuestionType;      // Question type (Select, Checklist, Info, Group, Product)
+  question: string;                     // Question text to display
+  options?: Array<{                     // Available answer options
+    value: string;
+    label: string;
+    nextQuestion?: ReturnProcessQuestion;  // Branching to next question
+  }>;
+  questions?: ReturnProcessQuestion[];  // Sub-questions for Group type
+}
+```
+
+**Question Types:**
+- `Select` - Single choice from options
+- `Checklist` - Multiple choice with optional "other" text
+- `Info` - Informational display (auto-answered)
+- `Group` - Container for multiple related questions
+- `Product` - Product-specific question
+
+### State Management with NgRx Signals
+
+The library provides three signal stores with different persistence strategies:
+
+#### 1. ReturnSearchStore (Session Storage)
+```typescript
+export const ReturnSearchStore = signalStore(
+  { providedIn: 'root' },
+  withStorage('oms-data-access.return-search-store', SessionStorageProvider),
+  withEntities<ReturnSearchEntity>(config),
+  // ...
+);
+```
+
+- **Purpose**: Manage search results and pagination
+- **Persistence**: SessionStorage (cleared when tab closes)
+- **Entity**: ReturnSearchEntity with status, items, hits
+- **Features**: Paginated search, status tracking (Idle, Pending, Success, Error)
+
+#### 2. ReturnProcessStore (IndexedDB)
+```typescript
+export const ReturnProcessStore = signalStore(
+  { providedIn: 'root' },
+  withStorage('return-process', IDBStorageProvider),
+  withEntities<ReturnProcess>(),
+  // ...
+);
+```
+
+- **Purpose**: Manage active return processes
+- **Persistence**: IndexedDB (survives tab close, persistent across sessions)
+- **Entity**: ReturnProcess with answers, product category, receipt info
+- **Features**: Answer management, process completion tracking
+
+#### 3. ReturnDetailsStore (No Persistence)
+```typescript
+export const ReturnDetailsStore = signalStore(
+  withState(initialState),
+  withEntities(receiptConfig),
+  // ...
+);
+```
+
+- **Purpose**: Manage receipt details and item selection
+- **Persistence**: None (in-memory only)
+- **Features**: Item selection, category/quantity management, canReturn checks
+
+### Validation with Zod
+
+All input parameters and API payloads are validated using Zod schemas:
+
+```typescript
+import { QueryTokenSchema, ReturnReceiptValuesSchema } from '@isa/oms/data-access';
+
+// Automatic validation in services
+const validatedToken = QueryTokenSchema.parse(queryToken);
+
+// Safe parsing with error handling
+const result = ReturnReceiptValuesSchema.safeParse(payload);
+if (!result.success) {
+  console.error('Validation failed:', result.error);
+}
+```
+
+**Key Schemas:**
+- `QueryTokenSchema` - Search query validation
+- `FetchReturnDetailsSchema` - Receipt detail fetch params
+- `ReturnReceiptValuesSchema` - Return submission payload
+- `ReturnProcessChecklistAnswerSchema` - Checklist answer validation
+
+## API Reference
+
+### Services
+
+#### ReturnSearchService
+
+Service for searching receipts in the OMS system.
+
+##### `querySettings(): Observable<QuerySettingsDTO>`
+
+Fetches query settings for receipt search configuration.
+
+**Returns:** Observable containing query settings (available filters, sort options)
+
+**Example:**
+```typescript
+this.#returnSearchService.querySettings().subscribe(settings => {
+  console.log('Available filters:', settings.filters);
+});
+```
+
+##### `search(queryToken: QueryTokenInput): Observable<ListResponseArgs<ReceiptListItem>>`
+
+Executes a search for receipts based on query parameters.
+
+**Parameters:**
+- `queryToken: QueryTokenInput` - Search parameters (validated with Zod)
+  - `input.qs` - Search query string
+  - `filter` - Filter criteria (e.g., receipt_type)
+  - `take` - Number of results to return
+  - `skip` - Number of results to skip (pagination)
+
+**Returns:** Observable containing list of receipt items with metadata
+
+**Throws:**
+- `ReturnParseQueryTokenError` - If query token validation fails
+- `ReturnSearchSearchError` - If search fails due to API error
+
+**Example:**
+```typescript
+this.#returnSearchService.search({
+  input: { qs: 'smith@example.com' },
+  filter: { receipt_type: '1;128;1024' },
+  take: 20,
+  skip: 0
+}).subscribe({
+  next: (results) => console.log(`Found ${results.hits} receipts`),
+  error: (error) => console.error('Search failed:', error)
+});
+```
+
+---
+
+#### ReturnDetailsService
+
+Service for managing receipt details and return eligibility.
+
+##### `fetchReturnDetails(params: FetchReturnDetails, abortSignal?: AbortSignal): Promise<Receipt>`
+
+Fetches detailed receipt information including items, buyer, and shipping.
+
+**Parameters:**
+- `params.receiptId: number` - Receipt ID to fetch (validated with Zod)
+- `abortSignal?: AbortSignal` - Optional signal to cancel request
+
+**Returns:** Promise resolving to complete Receipt with items
+
+**Throws:** Error if receipt not found or API error
+
+**Example:**
+```typescript
+const receipt = await this.#returnDetailsService.fetchReturnDetails(
+  { receiptId: 12345 },
+  abortController.signal
+);
+
+console.log(`Receipt ${receipt.receiptNumber} has ${receipt.items.length} items`);
+```
+
+##### `fetchReceiptsByEmail(params: { email: string }, abortSignal?: AbortSignal): Promise<ReceiptListItem[]>`
+
+Fetches all receipts associated with an email address.
+
+**Parameters:**
+- `params.email: string` - Email address to search for
+- `abortSignal?: AbortSignal` - Optional signal to cancel request
+
+**Returns:** Promise resolving to array of receipt list items
+
+**Example:**
+```typescript
+const receipts = await this.#returnDetailsService.fetchReceiptsByEmail({
+  email: 'customer@example.com'
+});
+
+receipts.forEach(r => console.log(`Receipt: ${r.receiptNumber}`));
+```
+
+##### `canReturn(params: { receiptItemId: number, quantity: number, category: ProductCategory }, abortSignal?: AbortSignal): Promise<CanReturn>`
+
+Checks if a specific receipt item can be returned.
+
+**Parameters:**
+- `params.receiptItemId: number` - ID of receipt item to check
+- `params.quantity: number` - Quantity to return
+- `params.category: ProductCategory` - Product category
+- `abortSignal?: AbortSignal` - Optional signal to cancel request
+
+**Returns:** Promise resolving to CanReturn result with eligibility info
+
+**Example:**
+```typescript
+const canReturn = await this.#returnDetailsService.canReturn({
+  receiptItemId: 456,
+  quantity: 1,
+  category: ProductCategory.ElektronischeGeraete
+});
+
+if (canReturn.result) {
+  console.log('Item can be returned');
+} else {
+  console.log('Return not allowed:', canReturn.message);
+}
+```
+
+##### `availableCategories(): KeyValue<ProductCategory, string>[]`
+
+Gets all available product categories (excludes Unknown).
+
+**Returns:** Array of key-value pairs representing categories
+
+**Example:**
+```typescript
+const categories = this.#returnDetailsService.availableCategories();
+categories.forEach(cat => {
+  console.log(`${cat.key}: ${cat.value}`);
+});
+```
+
+---
+
+#### ReturnProcessService
+
+Service for managing the return process workflow including questions and eligibility.
+
+##### `activeReturnProcessQuestions(process: ReturnProcess): ReturnProcessQuestion[] | undefined`
+
+Gets active questions based on answers provided so far.
+
+**Parameters:**
+- `process: ReturnProcess` - The return process containing answers
+
+**Returns:** Array of active questions, or undefined if no questions apply
+
+**Throws:**
+- `PropertyNullOrUndefinedError` - If questions cannot be found
+- `Error` - If cyclic question dependencies detected
+
+**Example:**
+```typescript
+const questions = this.#returnProcessService.activeReturnProcessQuestions(process);
+
+questions?.forEach(q => {
+  console.log(`Question: ${q.question}`);
+  if (q.type === ReturnProcessQuestionType.Select) {
+    q.options?.forEach(opt => console.log(`  - ${opt.label}`));
+  }
+});
+```
+
+##### `returnProcessQuestionsProgress(returnProcess: ReturnProcess): { answered: number; total: number } | undefined`
+
+Calculates question progress for the return process.
+
+**Parameters:**
+- `returnProcess: ReturnProcess` - The return process to analyze
+
+**Returns:** Object with answered and total question counts, or undefined
+
+**Example:**
+```typescript
+const progress = this.#returnProcessService.returnProcessQuestionsProgress(process);
+if (progress) {
+  console.log(`Progress: ${progress.answered}/${progress.total}`);
+  const percentage = (progress.answered / progress.total) * 100;
+  console.log(`${percentage}% complete`);
+}
+```
+
+##### `eligibleForReturn(returnProcess: ReturnProcess): EligibleForReturn | undefined`
+
+Determines if the product is eligible for return based on answers.
+
+**Parameters:**
+- `returnProcess: ReturnProcess` - The return process with complete answers
+
+**Returns:** Eligibility status, or undefined if questions incomplete
+
+**Example:**
+```typescript
+const eligibility = this.#returnProcessService.eligibleForReturn(process);
+
+switch (eligibility?.state) {
+  case EligibleForReturnState.Eligible:
+    console.log('Item is eligible for return');
+    break;
+  case EligibleForReturnState.NotEligible:
+    console.log('Item is not eligible:', eligibility.reason);
+    break;
+  case EligibleForReturnState.Unknown:
+    console.log('Cannot determine eligibility');
+    break;
+}
+```
+
+##### `getReturnInfo(process: ReturnProcess): ReturnInfo | undefined`
+
+Retrieves consolidated return information from answers.
+
+**Parameters:**
+- `process: ReturnProcess` - The return process
+
+**Returns:** Consolidated return information or undefined
+
+**Example:**
+```typescript
+const info = this.#returnProcessService.getReturnInfo(process);
+if (info) {
+  console.log('Return reason:', info.reason);
+  console.log('Additional notes:', info.notes);
+}
+```
+
+##### `completeReturnProcess(processes: ReturnProcess[]): Promise<Receipt[]>`
+
+Completes the return process and generates return receipts.
+
+**Parameters:**
+- `processes: ReturnProcess[]` - Array of return processes to complete
+
+**Returns:** Promise resolving to generated return receipts
+
+**Throws:**
+- `PropertyNullOrUndefinedError` - If processes is null/undefined
+- `PropertyIsEmptyError` - If processes array is empty
+- `ReturnProcessIsNotCompleteError` - If any process has unanswered questions
+
+**Example:**
+```typescript
+try {
+  const receipts = await this.#returnProcessService.completeReturnProcess([
+    process1,
+    process2
+  ]);
+
+  console.log(`Generated ${receipts.length} return receipts`);
+  receipts.forEach(r => console.log(`Return receipt: ${r.receiptNumber}`));
+} catch (error) {
+  if (error instanceof ReturnProcessIsNotCompleteError) {
+    console.error('Please answer all questions before completing');
+  }
+}
+```
+
+---
+
+#### OrderCreationService
+
+Service for creating orders from checkout.
+
+##### `createOrdersFromCheckout(checkoutId: number): Promise<Order[]>`
+
+Creates orders from a completed checkout.
+
+**Parameters:**
+- `checkoutId: number` - The checkout ID to create orders from
+
+**Returns:** Promise resolving to array of created orders
+
+**Throws:**
+- `Error` - If checkoutId is invalid
+- `ResponseArgsError` - If order creation fails
+
+**Example:**
+```typescript
+const orders = await this.#orderCreationService.createOrdersFromCheckout(12345);
+orders.forEach(order => {
+  console.log(`Order ${order.orderNumber} created`);
+});
+```
+
+##### `getLogistician(logisticianNumber = '2470', abortSignal?: AbortSignal): Promise<LogisticianDTO>`
+
+Retrieves logistician information.
+
+**Parameters:**
+- `logisticianNumber: string` - Logistician number (defaults to '2470')
+- `abortSignal?: AbortSignal` - Optional signal to cancel request
+
+**Returns:** Promise resolving to logistician data
+
+**Throws:**
+- `ResponseArgsError` - If request fails
+- `Error` - If logistician not found
+
+**Example:**
+```typescript
+const logistician = await this.#orderCreationService.getLogistician('2470');
+console.log(`Logistician: ${logistician.name}`);
+```
+
+---
+
+#### PrintReceiptsService
+
+Service for printing return receipts.
+
+##### `printReturnReceipts({ returnReceiptIds }: { returnReceiptIds: number[] }): Promise<void>`
+
+Prints return receipts to a label printer.
+
+**Parameters:**
+- `returnReceiptIds: number[]` - Array of return receipt IDs to print
+
+**Returns:** Promise that resolves when printing is complete
+
+**Throws:** Error if no receipt IDs provided
+
+**Example:**
+```typescript
+await this.#printReceiptsService.printReturnReceipts({
+  returnReceiptIds: [123, 124, 125]
+});
+console.log('Receipts sent to printer');
+```
+
+---
+
+### Facades
+
+#### OrderCreationFacade
+
+Simplified interface for order creation operations. Delegates to OrderCreationService.
+
+**Methods:**
+- `createOrdersFromCheckout(checkoutId: number): Promise<Order[]>`
+- `getLogistician(logisticianNumber = '2470', abortSignal?: AbortSignal): Promise<LogisticianDTO>`
+
+**Note:** This is a pass-through facade. Consider injecting OrderCreationService directly unless future orchestration logic is planned.
+
+---
+
+### Stores
+
+For detailed store usage and examples, see the [Usage Examples](#usage-examples) section.
+
+#### ReturnSearchStore
+
+Signal store for managing receipt search state with session persistence.
+
+**Key Methods:**
+- `getEntity(processId)` - Get search entity by process ID
+- `search(params)` - Execute search with rxMethod
+- `removeAllEntitiesByProcessId(processId)` - Clean up search results
+
+#### ReturnProcessStore
+
+Signal store for managing return process entities with IndexedDB persistence.
+
+**Key Methods:**
+- `startProcess(params)` - Initialize return process
+- `setAnswer(id, question, answer)` - Set question answer
+- `removeAnswer(id, question)` - Remove question answer
+- `finishProcess(returnReceipts)` - Mark process complete
+- `removeAllEntitiesByProcessId(...processIds)` - Clean up processes
+
+#### ReturnDetailsStore
+
+Signal store for managing receipt details and item selection (in-memory).
+
+**Key Methods:**
+- `receiptResource(receiptId)` - Load receipt
+- `canReturnResource(receiptItem)` - Check return eligibility
+- `addSelectedItems(itemIds)` - Add items to selection
+- `setProductCategory(itemId, category)` - Set item category
+- `setQuantity(itemId, quantity)` - Set return quantity
+
+---
+
+### Helper Functions
+
+#### Return Process Helpers
+
+Key helper functions exported from `@isa/oms/data-access`:
+
+- `canReturnReceiptItem(item)` - Check if item is returnable
+- `getReceiptItemQuantity(item)` - Get item quantity
+- `getReceiptItemReturnedQuantity(item)` - Get returned quantity
+- `getReceiptItemProductCategory(item)` - Get item category
+- `receiptItemHasCategory(item, category)` - Check category match
+- `activeReturnProcessQuestions(questions, answers)` - Get active questions
+- `allReturnProcessQuestionsAnswered(params)` - Check completion
+- `calculateLongestQuestionDepth(questions, answers)` - Calculate question tree depth
+
+---
+
+### RxJS Operators
+
+#### `takeUntilAborted(signal: AbortSignal)`
+
+RxJS operator that completes the source Observable when an AbortSignal is aborted.
+
+**Example:**
+```typescript
+import { takeUntilAborted } from '@isa/oms/data-access';
+
+const abortController = new AbortController();
+
+observable$.pipe(
+  takeUntilAborted(abortController.signal)
+).subscribe({
+  next: (data) => console.log('Data:', data),
+  error: (err) => console.error('Aborted or failed')
+});
+
+// Cancel request
+abortController.abort();
+```
+
+---
+
+### Error Classes
+
+- `OmsError` - Base error class
+- `ReturnSearchSearchError` - Search failure
+- `ReturnParseQueryTokenError` - Query validation failure
+- `CreateReturnProcessError` - Process creation failure
+- `ReturnProcessIsNotCompleteError` - Incomplete process submission
+
+For detailed error handling patterns, see the [Error Handling](#error-handling) section.
+
+---
+
+## Usage Examples
+
+### Complete Return Workflow
+
+See the comprehensive workflow example in the full documentation above for a step-by-step guide covering:
+1. Searching for receipts
+2. Loading receipt details
+3. Selecting items for return
+4. Starting the return process
+5. Answering questions
+6. Checking eligibility
+7. Completing the return
+
+### Search with Pagination
+
+Example showing how to implement paginated receipt search with the ReturnSearchStore.
+
+### Dynamic Question Display
+
+Example component demonstrating how to render questions dynamically based on type and handle answers.
+
+## Return Process Workflow
+
+The return process follows this workflow:
+
+```
+Search Receipt → Load Details → Select Items → Start Process
+    → Answer Questions → Check Eligibility → Complete Return → Print Receipt
+```
+
+### Question Branching
+
+Questions support branching logic through the `nextQuestion` property, allowing different question flows based on previous answers.
+
+## Product Categories and Questions
+
+### Supported Categories
+
+- **BookCalendar** - Books and calendars (2 questions)
+- **TonDatentraeger** - Audio/data media (3-5 questions)
+- **SpielwarenPuzzle** - Toys and puzzles (2 questions)
+- **SonstigesNonbook** - Other non-book items (2 questions)
+- **ElektronischeGeraete** - Electronic devices (4-8 questions, complex branching)
+- **Tolino** - E-readers (6-12 questions, most complex)
+- **Unknown** - Uncategorized (0 questions, manual processing)
+
+Each category has specific questions and validation rules defined in the `CategoryQuestions` registry.
+
+## State Management
+
+### Persistence Strategies
+
+- **ReturnSearchStore**: SessionStorage (tab-scoped, cleared on close)
+- **ReturnProcessStore**: IndexedDB (persistent across sessions)
+- **ReturnDetailsStore**: In-memory (no persistence)
+
+### Orphaned Entity Cleanup
+
+All stores automatically clean up entities when tabs are closed using Angular effects and the `@isa/core/tabs` service.
+
+## Error Handling
+
+### Best Practices
+
+1. Use Zod `safeParse()` for input validation
+2. Handle service errors with try/catch
+3. Use Observable error callbacks for streams
+4. Check store entity status for error states
+5. Integrate with `@isa/core/logging` for debugging
+
+### Common Error Types
+
+- **Validation Errors**: ZodError from schema validation
+- **API Errors**: ResponseArgsError from API calls
+- **Business Logic Errors**: Custom OMS error classes
+- **Process Errors**: ReturnProcessIsNotCompleteError for incomplete submissions
+
+## Testing
+
+The library uses **Jest** with **Spectator** for testing.
+
+### Running Tests
+
+```bash
+# Run tests
+npx nx test oms-data-access --skip-nx-cache
+
+# Run with coverage
+npx nx test oms-data-access --code-coverage --skip-nx-cache
+
+# Run in watch mode
+npx nx test oms-data-access --watch
+```
+
+## Architecture Notes
+
+### Layer Architecture
+
+```
+Features → Facades → Services → Stores → Helpers → Generated APIs
+```
+
+### Design Patterns
+
+- **Service Layer Pattern** - Business logic encapsulation
+- **State Management Pattern** - NgRx Signals with persistence
+- **Question Registry Pattern** - Category-specific question lookup
+- **Helper Function Pattern** - Pure transformation functions
+- **Adapter Pattern** - API DTO to domain model mapping
+
+### Dependencies
+
+- `@angular/core` - Angular framework
+- `@ngrx/signals` - State management
+- `@generated/swagger/oms-api` - OMS API client
+- `@isa/core/logging` - Logging infrastructure
+- `@isa/core/tabs` - Tab management
+- `@isa/core/storage` - Storage providers
+- `zod` - Schema validation
+- `rxjs` - Reactive programming
+
+### Path Alias
+
+Import from: `@isa/oms/data-access`
+
+---
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/oms/data-access/src/index.ts b/libs/oms/data-access/src/index.ts
index b249bfe1b..b6f115547 100644
--- a/libs/oms/data-access/src/index.ts
+++ b/libs/oms/data-access/src/index.ts
@@ -6,6 +6,7 @@
  *
  * Core components:
  * - Models: Type definitions for data structures
+ * - Facades: Simplified interfaces for order creation operations
  * - Services: API integrations for data retrieval and manipulation
  * - Stores: State management for OMS-related data
  * - Schemas: Validation schemas for ensuring data integrity
@@ -17,6 +18,7 @@
 export * from './lib/errors';
 export * from './lib/questions';
 export * from './lib/models';
+export * from './lib/facades';
 export * from './lib/helpers/return-process';
 export * from './lib/schemas';
 export * from './lib/services';
diff --git a/libs/oms/data-access/src/lib/constants.ts b/libs/oms/data-access/src/lib/constants.ts
new file mode 100644
index 000000000..796830f84
--- /dev/null
+++ b/libs/oms/data-access/src/lib/constants.ts
@@ -0,0 +1 @@
+export const OMS_DISPLAY_ORDERS_KEY = 'OMS-DATA-ACCESS.DISPLAY_ORDERS';
diff --git a/libs/oms/data-access/src/lib/facades/index.ts b/libs/oms/data-access/src/lib/facades/index.ts
new file mode 100644
index 000000000..ae27d95e7
--- /dev/null
+++ b/libs/oms/data-access/src/lib/facades/index.ts
@@ -0,0 +1 @@
+export { OrderCreationFacade } from './order-creation.facade';
diff --git a/libs/oms/data-access/src/lib/facades/order-creation.facade.spec.ts b/libs/oms/data-access/src/lib/facades/order-creation.facade.spec.ts
new file mode 100644
index 000000000..f21186ecd
--- /dev/null
+++ b/libs/oms/data-access/src/lib/facades/order-creation.facade.spec.ts
@@ -0,0 +1,145 @@
+import { createServiceFactory, SpectatorService } from '@ngneat/spectator/jest';
+import { OrderCreationFacade } from './order-creation.facade';
+import { OrderCreationService } from '../services';
+import { LogisticianDTO } from '@generated/swagger/oms-api';
+import { Order } from '../models';
+
+describe('OrderCreationFacade', () => {
+  let spectator: SpectatorService<OrderCreationFacade>;
+  const createService = createServiceFactory({
+    service: OrderCreationFacade,
+    mocks: [OrderCreationService],
+  });
+
+  beforeEach(() => {
+    spectator = createService();
+  });
+
+  describe('createOrdersFromCheckout', () => {
+    it('should delegate to OrderCreationService.createOrdersFromCheckout', async () => {
+      // Arrange
+      const checkoutId = 123;
+      const mockOrders: Order[] = [
+        { id: 1 } as Order,
+        { id: 2 } as Order,
+      ];
+      const orderCreationService = spectator.inject(OrderCreationService);
+      (orderCreationService.createOrdersFromCheckout as jest.Mock).mockResolvedValue(mockOrders);
+
+      // Act
+      const result = await spectator.service.createOrdersFromCheckout(checkoutId);
+
+      // Assert
+      expect(result).toEqual(mockOrders);
+      expect(orderCreationService.createOrdersFromCheckout).toHaveBeenCalledWith(
+        checkoutId,
+      );
+      expect(orderCreationService.createOrdersFromCheckout).toHaveBeenCalledTimes(1);
+    });
+
+    it('should propagate errors from OrderCreationService', async () => {
+      // Arrange
+      const checkoutId = 0;
+      const errorMessage = 'Invalid checkoutId: 0';
+      const orderCreationService = spectator.inject(OrderCreationService);
+      (orderCreationService.createOrdersFromCheckout as jest.Mock).mockRejectedValue(
+        new Error(errorMessage)
+      );
+
+      // Act & Assert
+      await expect(
+        spectator.service.createOrdersFromCheckout(checkoutId),
+      ).rejects.toThrow(errorMessage);
+      expect(orderCreationService.createOrdersFromCheckout).toHaveBeenCalledWith(
+        checkoutId,
+      );
+    });
+  });
+
+  describe('getLogistician', () => {
+    it('should delegate to OrderCreationService.getLogistician with default logisticianNumber', async () => {
+      // Arrange
+      const mockLogistician: LogisticianDTO = {
+        logisticianNumber: '2470',
+        name: 'Default Logistician',
+      } as LogisticianDTO;
+      const orderCreationService = spectator.inject(OrderCreationService);
+      (orderCreationService.getLogistician as jest.Mock).mockResolvedValue(mockLogistician);
+
+      // Act
+      const result = await spectator.service.getLogistician();
+
+      // Assert
+      expect(result).toEqual(mockLogistician);
+      expect(orderCreationService.getLogistician).toHaveBeenCalledWith(
+        '2470',
+        undefined,
+      );
+      expect(orderCreationService.getLogistician).toHaveBeenCalledTimes(1);
+    });
+
+    it('should delegate to OrderCreationService.getLogistician with custom logisticianNumber', async () => {
+      // Arrange
+      const logisticianNumber = '1000';
+      const mockLogistician: LogisticianDTO = {
+        logisticianNumber,
+        name: 'Custom Logistician',
+      } as LogisticianDTO;
+      const orderCreationService = spectator.inject(OrderCreationService);
+      (orderCreationService.getLogistician as jest.Mock).mockResolvedValue(mockLogistician);
+
+      // Act
+      const result = await spectator.service.getLogistician(logisticianNumber);
+
+      // Assert
+      expect(result).toEqual(mockLogistician);
+      expect(orderCreationService.getLogistician).toHaveBeenCalledWith(
+        logisticianNumber,
+        undefined,
+      );
+    });
+
+    it('should delegate to OrderCreationService.getLogistician with abortSignal', async () => {
+      // Arrange
+      const logisticianNumber = '2470';
+      const abortSignal = new AbortController().signal;
+      const mockLogistician: LogisticianDTO = {
+        logisticianNumber,
+        name: 'Default Logistician',
+      } as LogisticianDTO;
+      const orderCreationService = spectator.inject(OrderCreationService);
+      (orderCreationService.getLogistician as jest.Mock).mockResolvedValue(mockLogistician);
+
+      // Act
+      const result = await spectator.service.getLogistician(
+        logisticianNumber,
+        abortSignal,
+      );
+
+      // Assert
+      expect(result).toEqual(mockLogistician);
+      expect(orderCreationService.getLogistician).toHaveBeenCalledWith(
+        logisticianNumber,
+        abortSignal,
+      );
+    });
+
+    it('should propagate errors from OrderCreationService', async () => {
+      // Arrange
+      const errorMessage = 'Logistician 2470 not found';
+      const orderCreationService = spectator.inject(OrderCreationService);
+      (orderCreationService.getLogistician as jest.Mock).mockRejectedValue(
+        new Error(errorMessage)
+      );
+
+      // Act & Assert
+      await expect(spectator.service.getLogistician()).rejects.toThrow(
+        errorMessage,
+      );
+      expect(orderCreationService.getLogistician).toHaveBeenCalledWith(
+        '2470',
+        undefined,
+      );
+    });
+  });
+});
diff --git a/libs/oms/data-access/src/lib/facades/order-creation.facade.ts b/libs/oms/data-access/src/lib/facades/order-creation.facade.ts
new file mode 100644
index 000000000..82ce0dfba
--- /dev/null
+++ b/libs/oms/data-access/src/lib/facades/order-creation.facade.ts
@@ -0,0 +1,46 @@
+import { inject, Injectable } from '@angular/core';
+import { LogisticianDTO } from '@generated/swagger/oms-api';
+import { Order } from '../models';
+import { OrderCreationService } from '../services';
+
+/**
+ * Facade for order creation operations.
+ *
+ * @remarks
+ * This facade provides a simplified interface for creating orders from checkout
+ * and retrieving logistician information. It delegates to OrderCreationService
+ * for all operations.
+ */
+@Injectable({ providedIn: 'root' })
+export class OrderCreationFacade {
+  #orderCreationService = inject(OrderCreationService);
+
+  /**
+   * Creates orders from a checkout.
+   *
+   * @param checkoutId - The ID of the checkout to create orders from
+   * @returns Promise resolving to array of created orders
+   * @throws {Error} If checkoutId is invalid or order creation fails
+   */
+  async createOrdersFromCheckout(checkoutId: number): Promise<Order[]> {
+    return this.#orderCreationService.createOrdersFromCheckout(checkoutId);
+  }
+
+  /**
+   * Retrieves logistician information.
+   *
+   * @param logisticianNumber - The logistician number to retrieve (defaults to '2470')
+   * @param abortSignal - Optional signal to abort the operation
+   * @returns Promise resolving to logistician data
+   * @throws {Error} If logistician is not found or request fails
+   */
+  async getLogistician(
+    logisticianNumber = '2470',
+    abortSignal?: AbortSignal,
+  ): Promise<LogisticianDTO> {
+    return this.#orderCreationService.getLogistician(
+      logisticianNumber,
+      abortSignal,
+    );
+  }
+}
diff --git a/libs/oms/data-access/src/lib/helpers/return-process/can-return-receipt-item.helper.spec.ts b/libs/oms/data-access/src/lib/helpers/return-process/can-return-receipt-item.helper.spec.ts
index 1c890ff03..fb8899b23 100644
--- a/libs/oms/data-access/src/lib/helpers/return-process/can-return-receipt-item.helper.spec.ts
+++ b/libs/oms/data-access/src/lib/helpers/return-process/can-return-receipt-item.helper.spec.ts
@@ -1,6 +1,6 @@
 import { canReturnReceiptItem } from './can-return-receipt-item.helper';
 import { ReceiptItem } from '../../models/receipt-item';
-import { Product } from '../../models/product';
+import { Product } from '../../schemas/product.schema';
 import { Quantity } from '../../models/quantity';
 
 describe('canReturnReceiptItem', () => {
diff --git a/libs/oms/data-access/src/lib/helpers/return-process/get-receipt-item-action.helper.spec.ts b/libs/oms/data-access/src/lib/helpers/return-process/get-receipt-item-action.helper.spec.ts
index ba0a15a71..bb7d2b289 100644
--- a/libs/oms/data-access/src/lib/helpers/return-process/get-receipt-item-action.helper.spec.ts
+++ b/libs/oms/data-access/src/lib/helpers/return-process/get-receipt-item-action.helper.spec.ts
@@ -1,6 +1,6 @@
 import { getReceiptItemAction } from './get-receipt-item-action.helper';
 import { ReceiptItem } from '../../models/receipt-item';
-import { Product } from '../../models/product';
+import { Product } from '../../schemas/product.schema';
 import { Quantity } from '../../models/quantity';
 
 describe('getReceiptItemAction', () => {
diff --git a/libs/oms/data-access/src/lib/helpers/return-process/get-receipt-item-product-category.helper.spec.ts b/libs/oms/data-access/src/lib/helpers/return-process/get-receipt-item-product-category.helper.spec.ts
index fd4e9d462..0c5710065 100644
--- a/libs/oms/data-access/src/lib/helpers/return-process/get-receipt-item-product-category.helper.spec.ts
+++ b/libs/oms/data-access/src/lib/helpers/return-process/get-receipt-item-product-category.helper.spec.ts
@@ -1,6 +1,6 @@
 import { getReceiptItemProductCategory } from './get-receipt-item-product-category.helper';
 import { ReceiptItem } from '../../models/receipt-item';
-import { Product } from '../../models/product';
+import { Product } from '../../schemas/product.schema';
 import { Quantity } from '../../models/quantity';
 import { ProductCategory } from '../../questions/constants';
 
diff --git a/libs/oms/data-access/src/lib/helpers/return-process/get-return-info.helper.ts b/libs/oms/data-access/src/lib/helpers/return-process/get-return-info.helper.ts
index 501f4b6ab..16dd3ead4 100644
--- a/libs/oms/data-access/src/lib/helpers/return-process/get-return-info.helper.ts
+++ b/libs/oms/data-access/src/lib/helpers/return-process/get-return-info.helper.ts
@@ -1,12 +1,12 @@
 import { isEmpty } from 'lodash';
 import {
-  Product,
   ReturnInfo,
   ReturnProcessAnswers,
   ReturnProcessQuestion,
   ReturnProcessQuestionKey,
   ReturnProcessQuestionType,
 } from '../../models';
+import { Product } from '../../schemas/product.schema';
 import {
   activeReturnProcessQuestions,
   internalActiveReturnProcessQuestions,
diff --git a/libs/oms/data-access/src/lib/helpers/return-process/receipt-item-has-category.helper.spec.ts b/libs/oms/data-access/src/lib/helpers/return-process/receipt-item-has-category.helper.spec.ts
index ee356f33f..50a78da5c 100644
--- a/libs/oms/data-access/src/lib/helpers/return-process/receipt-item-has-category.helper.spec.ts
+++ b/libs/oms/data-access/src/lib/helpers/return-process/receipt-item-has-category.helper.spec.ts
@@ -1,6 +1,6 @@
 import { receiptItemHasCategory } from './receipt-item-has-category.helper';
 import { ReceiptItem } from '../../models/receipt-item';
-import { Product } from '../../models/product';
+import { Product } from '../../schemas/product.schema';
 import { Quantity } from '../../models/quantity';
 import { ProductCategory } from '../../questions/constants';
 
diff --git a/libs/oms/data-access/src/lib/models/index.ts b/libs/oms/data-access/src/lib/models/index.ts
index 9b210eaac..310a98693 100644
--- a/libs/oms/data-access/src/lib/models/index.ts
+++ b/libs/oms/data-access/src/lib/models/index.ts
@@ -5,7 +5,6 @@ export * from './eligible-for-return';
 export * from './gender';
 export * from './logistician';
 export * from './order';
-export * from './product';
 export * from './quantity';
 export * from './receipt-item-list-item';
 export * from './receipt-item-task-list-item';
@@ -21,5 +20,4 @@ export * from './return-process-question';
 export * from './return-process-status';
 export * from './return-process';
 export * from './shipping-address-2';
-export * from './shipping-type';
 export * from './task-action-type';
diff --git a/libs/oms/data-access/src/lib/models/product.ts b/libs/oms/data-access/src/lib/models/product.ts
deleted file mode 100644
index 69ef208cc..000000000
--- a/libs/oms/data-access/src/lib/models/product.ts
+++ /dev/null
@@ -1,12 +0,0 @@
-import { ProductDTO } from '@generated/swagger/oms-api';
-
-export interface Product extends ProductDTO {
-  name: string;
-  contributors: string;
-  catalogProductNumber: string;
-  ean: string;
-  format: string;
-  formatDetail: string;
-  volume: string;
-  manufacturer: string;
-}
diff --git a/libs/oms/data-access/src/lib/models/receipt-item-list-item.ts b/libs/oms/data-access/src/lib/models/receipt-item-list-item.ts
index 49de292e9..4283b3b88 100644
--- a/libs/oms/data-access/src/lib/models/receipt-item-list-item.ts
+++ b/libs/oms/data-access/src/lib/models/receipt-item-list-item.ts
@@ -1,5 +1,5 @@
 import { ReceiptItemListItemDTO } from '@generated/swagger/oms-api';
-import { Product } from './product';
+import { Product } from '../schemas/product.schema';
 import { Quantity } from './quantity';
 
 export interface ReceiptItemListItem extends ReceiptItemListItemDTO {
diff --git a/libs/oms/data-access/src/lib/models/receipt-item.ts b/libs/oms/data-access/src/lib/models/receipt-item.ts
index ca691f5f0..30f2bf839 100644
--- a/libs/oms/data-access/src/lib/models/receipt-item.ts
+++ b/libs/oms/data-access/src/lib/models/receipt-item.ts
@@ -1,5 +1,5 @@
 import { ReceiptItemDTO } from '@generated/swagger/oms-api';
-import { Product } from './product';
+import { Product } from '../schemas/product.schema';
 import { Quantity } from './quantity';
 
 export interface ReceiptItem extends ReceiptItemDTO {
diff --git a/libs/oms/data-access/src/lib/models/return-info.ts b/libs/oms/data-access/src/lib/models/return-info.ts
index 7749ddcd3..5a2323f0e 100644
--- a/libs/oms/data-access/src/lib/models/return-info.ts
+++ b/libs/oms/data-access/src/lib/models/return-info.ts
@@ -1,4 +1,4 @@
-import { Product } from './product';
+import { Product } from '../schemas/product.schema';
 import { ReturnProcessQuestionKey } from './return-process-question-key';
 
 /**
diff --git a/libs/oms/data-access/src/lib/models/shipping-type.ts b/libs/oms/data-access/src/lib/models/shipping-type.ts
deleted file mode 100644
index 565151440..000000000
--- a/libs/oms/data-access/src/lib/models/shipping-type.ts
+++ /dev/null
@@ -1,11 +0,0 @@
-export enum ShippingType {
-  NotSet = 0,
-  PostCard = 1,
-  Letter = 2,
-  LargeLetter = 4,
-  BookRate = 8,
-  MerchandiseShipment = 16,
-  Parcel = 32,
-  Palette = 64,
-  MerchandiseShipmentSmall = 128,
-}
diff --git a/libs/oms/data-access/src/lib/schemas/display-addressee.schema.ts b/libs/oms/data-access/src/lib/schemas/display-addressee.schema.ts
new file mode 100644
index 000000000..fa63f6893
--- /dev/null
+++ b/libs/oms/data-access/src/lib/schemas/display-addressee.schema.ts
@@ -0,0 +1,23 @@
+import {
+  AddressSchema,
+  CommunicationDetailsSchema,
+  ExternalReferenceSchema,
+  GenderSchema,
+  OrganisationSchema,
+} from '@isa/common/data-access';
+import { z } from 'zod';
+
+export const DisplayAddresseeSchema = z.object({
+  number: z.string().describe('Number').optional(),
+  locale: z.string().describe('Locale').optional(),
+  gender: GenderSchema.describe('Gender'),
+  title: z.string().describe('Title').optional(),
+  firstName: z.string().describe('First name').optional(),
+  lastName: z.string().describe('Last name').optional(),
+  organisation: OrganisationSchema.describe('Organisation information').optional(),
+  address: AddressSchema.describe('Address').optional(),
+  communicationDetails: CommunicationDetailsSchema.describe('Communication details').optional(),
+  externalReference: ExternalReferenceSchema.describe('External system reference').optional(),
+});
+
+export type DisplayAddressee = z.infer<typeof DisplayAddresseeSchema>;
diff --git a/libs/oms/data-access/src/lib/schemas/display-branch.schema.ts b/libs/oms/data-access/src/lib/schemas/display-branch.schema.ts
new file mode 100644
index 000000000..28682cb4b
--- /dev/null
+++ b/libs/oms/data-access/src/lib/schemas/display-branch.schema.ts
@@ -0,0 +1,19 @@
+import {
+  AddressSchema,
+  CommunicationDetailsSchema,
+  EntitySchema,
+} from '@isa/common/data-access';
+import { z } from 'zod';
+
+export const DisplayBranchSchema = z
+  .object({
+    name: z.string().describe('Name').optional(),
+    key: z.string().describe('Key').optional(),
+    branchNumber: z.string().describe('Branch number').optional(),
+    address: AddressSchema.describe('Address').optional(),
+    communicationDetails: CommunicationDetailsSchema.describe('Communication details').optional(),
+    web: z.string().describe('Web').optional(),
+  })
+  .extend(EntitySchema.shape);
+
+export type DisplayBranch = z.infer<typeof DisplayBranchSchema>;
diff --git a/libs/oms/data-access/src/lib/schemas/display-logistician.schema.ts b/libs/oms/data-access/src/lib/schemas/display-logistician.schema.ts
new file mode 100644
index 000000000..6ae7f2cd1
--- /dev/null
+++ b/libs/oms/data-access/src/lib/schemas/display-logistician.schema.ts
@@ -0,0 +1,12 @@
+import { EntitySchema } from '@isa/common/data-access';
+import { z } from 'zod';
+
+export const DisplayLogisticianSchema = z
+  .object({
+    name: z.string().describe('Name').optional(),
+    logisticianNumber: z.string().describe('Logistician number').optional(),
+    gln: z.string().describe('Gln').optional(),
+  })
+  .extend(EntitySchema.shape);
+
+export type DisplayLogistician = z.infer<typeof DisplayLogisticianSchema>;
diff --git a/libs/oms/data-access/src/lib/schemas/display-order-item.schema.ts b/libs/oms/data-access/src/lib/schemas/display-order-item.schema.ts
new file mode 100644
index 000000000..733dfde47
--- /dev/null
+++ b/libs/oms/data-access/src/lib/schemas/display-order-item.schema.ts
@@ -0,0 +1,26 @@
+import { EntitySchema, QuantityUnitTypeSchema } from '@isa/common/data-access';
+import { z } from 'zod';
+import { PriceSchema } from './price.schema';
+import { ProductSchema } from './product.schema';
+import { PromotionSchema } from './promotion.schema';
+
+// Forward declaration for circular reference
+export const DisplayOrderItemSchema: z.ZodType<any> = z
+  .object({
+    buyerComment: z.string().describe('Buyer comment').optional(),
+    description: z.string().describe('Description text').optional(),
+    features: z.record(z.string().describe('Features'), z.string()).optional(),
+    order: z.lazy(() => z.any()).describe('Order').optional(), // Circular reference to DisplayOrder
+    orderDate: z.string().describe('Order date').optional(),
+    orderItemNumber: z.string().describe('OrderItem number').optional(),
+    price: PriceSchema.describe('Price information').optional(),
+    product: ProductSchema.describe('Product').optional(),
+    promotion: PromotionSchema.describe('Promotion information').optional(),
+    quantity: z.number().describe('Quantity').optional(),
+    quantityUnit: z.string().describe('Quantity unit').optional(),
+    quantityUnitType: QuantityUnitTypeSchema.describe('QuantityUnit type'),
+    subsetItems: z.array(z.lazy(() => z.any())).describe('Subset items').optional(), // Circular reference to DisplayOrderItemSubset
+  })
+  .extend(EntitySchema.shape);
+
+export type DisplayOrderItem = z.infer<typeof DisplayOrderItemSchema>;
diff --git a/libs/oms/data-access/src/lib/schemas/display-order-payment.schema.ts b/libs/oms/data-access/src/lib/schemas/display-order-payment.schema.ts
new file mode 100644
index 000000000..6115a2c3d
--- /dev/null
+++ b/libs/oms/data-access/src/lib/schemas/display-order-payment.schema.ts
@@ -0,0 +1,21 @@
+import { EntitySchema, PaymentTypeSchema } from '@isa/common/data-access';
+import { z } from 'zod';
+
+export const DisplayOrderPaymentSchema = z
+  .object({
+    paymentActionRequired: z.boolean().describe('Payment action required'),
+    paymentType: PaymentTypeSchema.describe('Payment type'),
+    paymentNumber: z.string().describe('Payment number').optional(),
+    paymentComment: z.string().describe('Payment comment').optional(),
+    total: z.number().describe('Total amount'),
+    subtotal: z.number().describe('Subtotal').optional(),
+    shipping: z.number().describe('Shipping').optional(),
+    tax: z.number().describe('Tax amount').optional(),
+    currency: z.string().describe('Currency code').optional(),
+    dateOfPayment: z.string().describe('Date of payment').optional(),
+    completed: z.string().describe('Completed').optional(),
+    cancelled: z.string().describe('Cancelled').optional(),
+  })
+  .extend(EntitySchema.shape);
+
+export type DisplayOrderPayment = z.infer<typeof DisplayOrderPaymentSchema>;
diff --git a/libs/oms/data-access/src/lib/schemas/display-order.schema.ts b/libs/oms/data-access/src/lib/schemas/display-order.schema.ts
new file mode 100644
index 000000000..34d5cdded
--- /dev/null
+++ b/libs/oms/data-access/src/lib/schemas/display-order.schema.ts
@@ -0,0 +1,50 @@
+import {
+  BuyerTypeSchema,
+  EntitySchema,
+  KeyValueOfStringAndStringSchema,
+  NotificationChannelSchema,
+} from '@isa/common/data-access';
+import { z } from 'zod';
+import { DisplayAddresseeSchema } from './display-addressee.schema';
+import { DisplayBranchSchema } from './display-branch.schema';
+import { DisplayLogisticianSchema } from './display-logistician.schema';
+import { DisplayOrderItemSchema } from './display-order-item.schema';
+import { DisplayOrderPaymentSchema } from './display-order-payment.schema';
+import { EnvironmentChannelSchema } from './environment-channel.schema';
+import { LinkedRecordSchema } from './linked-record.schema';
+import { OrderTypeSchema } from './order-type.schema';
+import { TermsOfDeliverySchema } from './terms-of-delivery.schema';
+
+export const DisplayOrderSchema = z
+  .object({
+    actions: z.array(KeyValueOfStringAndStringSchema).describe('Actions').optional(),
+    buyer: DisplayAddresseeSchema.describe('Buyer information').optional(),
+    buyerComment: z.string().describe('Buyer comment').optional(),
+    buyerIsGuestAccount: z.boolean().describe('Buyer is guest account').optional(),
+    buyerNumber: z.string().describe('Unique buyer identifier number').optional(),
+    buyerType: BuyerTypeSchema.describe('Buyer type').optional(),
+    clientChannel: EnvironmentChannelSchema.describe('Client channel').optional(),
+    completedDate: z.string().describe('Completed date').optional(),
+    features: z.record(z.string().describe('Features'), z.string()).optional(),
+    items: z.array(DisplayOrderItemSchema).describe('List of items').optional(),
+    itemsCount: z.number().describe('Number of itemss').optional(),
+    linkedRecords: z.array(LinkedRecordSchema).describe('List of linked records').optional(),
+    logistician: DisplayLogisticianSchema.describe('Logistician information').optional(),
+    notificationChannels: NotificationChannelSchema.describe('Notification channels').optional(),
+    orderBranch: DisplayBranchSchema.describe('Order branch').optional(),
+    orderDate: z.string().describe('Order date').optional(),
+    orderNumber: z.string().describe('Order number').optional(),
+    orderType: OrderTypeSchema.describe('Order type'),
+    orderValue: z.number().describe('Order value').optional(),
+    orderValueCurrency: z.string().describe('Order value currency').optional(),
+    payer: DisplayAddresseeSchema.describe('Payer information').optional(),
+    payerIsGuestAccount: z.boolean().describe('Payer is guest account').optional(),
+    payerNumber: z.string().describe('Unique payer account number').optional(),
+    payment: DisplayOrderPaymentSchema.describe('Payment').optional(),
+    shippingAddress: DisplayAddresseeSchema.describe('Shipping address information').optional(),
+    targetBranch: DisplayBranchSchema.describe('Target branch').optional(),
+    termsOfDelivery: TermsOfDeliverySchema.describe('Terms of delivery').optional(),
+  })
+  .extend(EntitySchema.shape);
+
+export type DisplayOrder = z.infer<typeof DisplayOrderSchema>;
diff --git a/libs/oms/data-access/src/lib/schemas/environment-channel.schema.ts b/libs/oms/data-access/src/lib/schemas/environment-channel.schema.ts
new file mode 100644
index 000000000..a25d12ecb
--- /dev/null
+++ b/libs/oms/data-access/src/lib/schemas/environment-channel.schema.ts
@@ -0,0 +1,15 @@
+import { z } from 'zod';
+
+export const EnvironmentChannel = {
+  NotSet: 0,
+  System: 1,
+  Branch: 2,
+  CallCenter: 4,
+  WWW: 8,
+  Mobile: 16,
+  BackOffice: 32,
+} as const;
+
+export const EnvironmentChannelSchema = z.nativeEnum(EnvironmentChannel).describe('Environment channel');
+
+export type EnvironmentChannel = z.infer<typeof EnvironmentChannelSchema>;
diff --git a/libs/oms/data-access/src/lib/schemas/index.ts b/libs/oms/data-access/src/lib/schemas/index.ts
index 1b1d8aaa3..534c90dfe 100644
--- a/libs/oms/data-access/src/lib/schemas/index.ts
+++ b/libs/oms/data-access/src/lib/schemas/index.ts
@@ -1,4 +1,19 @@
+export * from './display-addressee.schema';
+export * from './display-branch.schema';
+export * from './display-logistician.schema';
+export * from './display-order-item.schema';
+export * from './display-order-payment.schema';
+export * from './display-order.schema';
+export * from './environment-channel.schema';
 export * from './fetch-return-details.schema';
+export * from './linked-record.schema';
+export * from './order-type.schema';
+export * from './price.schema';
+export * from './product.schema';
+export * from './promotion.schema';
 export * from './query-token.schema';
 export * from './return-process-question-answer.schema';
 export * from './return-receipt-values.schema';
+export * from './shipping-type.schema';
+export * from './terms-of-delivery.schema';
+export * from './type-of-delivery.schema';
diff --git a/libs/oms/data-access/src/lib/schemas/linked-record.schema.ts b/libs/oms/data-access/src/lib/schemas/linked-record.schema.ts
new file mode 100644
index 000000000..edef7dfef
--- /dev/null
+++ b/libs/oms/data-access/src/lib/schemas/linked-record.schema.ts
@@ -0,0 +1,10 @@
+import { z } from 'zod';
+
+export const LinkedRecordSchema = z.object({
+  repository: z.string().describe('Repository').optional(),
+  pk: z.string().describe('Pk').optional(),
+  number: z.string().describe('Number').optional(),
+  isSource: z.boolean().describe('Whether source').optional(),
+});
+
+export type LinkedRecord = z.infer<typeof LinkedRecordSchema>;
diff --git a/libs/oms/data-access/src/lib/schemas/order-type.schema.ts b/libs/oms/data-access/src/lib/schemas/order-type.schema.ts
new file mode 100644
index 000000000..a49c383b8
--- /dev/null
+++ b/libs/oms/data-access/src/lib/schemas/order-type.schema.ts
@@ -0,0 +1,14 @@
+import { z } from 'zod';
+
+export const OrderType = {
+  NotSet: 0,
+  Branch: 1,
+  Mail: 2,
+  Download: 4,
+  BranchAndDownload: 5, // Branch | Download
+  MailAndDownload: 6, // Mail | Download
+} as const;
+
+export const OrderTypeSchema = z.nativeEnum(OrderType).describe('Order type');
+
+export type OrderType = z.infer<typeof OrderTypeSchema>;
diff --git a/libs/oms/data-access/src/lib/schemas/price.schema.ts b/libs/oms/data-access/src/lib/schemas/price.schema.ts
new file mode 100644
index 000000000..6ee24ca74
--- /dev/null
+++ b/libs/oms/data-access/src/lib/schemas/price.schema.ts
@@ -0,0 +1,15 @@
+import {
+  PriceValueSchema,
+  TouchBaseSchema,
+  VatValueSchema,
+} from '@isa/common/data-access';
+import { z } from 'zod';
+
+export const PriceSchema = z
+  .object({
+    value: PriceValueSchema.describe('Value').optional(),
+    vat: VatValueSchema.describe('Value Added Tax').optional(),
+  })
+  .extend(TouchBaseSchema.shape);
+
+export type Price = z.infer<typeof PriceSchema>;
diff --git a/libs/oms/data-access/src/lib/schemas/product.schema.ts b/libs/oms/data-access/src/lib/schemas/product.schema.ts
new file mode 100644
index 000000000..09f5512d7
--- /dev/null
+++ b/libs/oms/data-access/src/lib/schemas/product.schema.ts
@@ -0,0 +1,27 @@
+import { TouchBaseSchema } from '@isa/common/data-access';
+import { z } from 'zod';
+
+export const ProductSchema = z
+  .object({
+    name: z.string().describe('Name').optional(),
+    additionalName: z.string().describe('Additional name').optional(),
+    ean: z.string().describe('European Article Number barcode').optional(),
+    supplierProductNumber: z.string().describe('SupplierProduct number').optional(),
+    catalogProductNumber: z.string().describe('CatalogProduct number').optional(),
+    contributors: z.string().describe('Contributors').optional(),
+    manufacturer: z.string().describe('Manufacturer information').optional(),
+    publicationDate: z.string().describe('Publication date').optional(),
+    productGroup: z.string().describe('Product group').optional(),
+    productGroupDetails: z.string().describe('Product group details').optional(),
+    edition: z.string().describe('Edition').optional(),
+    format: z.string().describe('Format').optional(),
+    formatDetail: z.string().describe('Format detail').optional(),
+    locale: z.string().describe('Locale').optional(),
+    serial: z.string().describe('Serial').optional(),
+    size: z.any().describe('Size').optional(), // TODO: Create SizeOfString schema
+    volume: z.string().describe('Volume').optional(),
+    weight: z.any().describe('Weight').optional(), // TODO: Create WeightOfAvoirdupois schema
+  })
+  .extend(TouchBaseSchema.shape);
+
+export type Product = z.infer<typeof ProductSchema>;
diff --git a/libs/oms/data-access/src/lib/schemas/promotion.schema.ts b/libs/oms/data-access/src/lib/schemas/promotion.schema.ts
new file mode 100644
index 000000000..271470136
--- /dev/null
+++ b/libs/oms/data-access/src/lib/schemas/promotion.schema.ts
@@ -0,0 +1,13 @@
+import { TouchBaseSchema } from '@isa/common/data-access';
+import { z } from 'zod';
+
+export const PromotionSchema = z
+  .object({
+    value: z.number().describe('Value').optional(),
+    type: z.string().describe('Type').optional(),
+    code: z.string().describe('Code value').optional(),
+    label: z.string().describe('Label').optional(),
+  })
+  .extend(TouchBaseSchema.shape);
+
+export type Promotion = z.infer<typeof PromotionSchema>;
diff --git a/libs/oms/data-access/src/lib/schemas/return-receipt-values.schema.ts b/libs/oms/data-access/src/lib/schemas/return-receipt-values.schema.ts
index 123b79ffe..3f4d0c8bd 100644
--- a/libs/oms/data-access/src/lib/schemas/return-receipt-values.schema.ts
+++ b/libs/oms/data-access/src/lib/schemas/return-receipt-values.schema.ts
@@ -1,19 +1,19 @@
 import { z } from 'zod';
-import { Product } from '../models/product';
+import { Product } from './product.schema';
 
 const ReceiptItemSchema = z.object({
-  id: z.number(),
+  id: z.number().describe('Unique identifier'),
 });
 
 export const ReturnReceiptValuesSchema = z.object({
-  quantity: z.number(),
-  category: z.string().optional(),
-  comment: z.string().optional(),
-  itemCondition: z.string().optional(),
-  returnDetails: z.string().optional(),
-  returnReason: z.string().optional(),
-  receiptItem: ReceiptItemSchema,
-  otherProduct: z.custom<Product>().optional(),
+  quantity: z.number().describe('Quantity'),
+  category: z.string().describe('Category information').optional(),
+  comment: z.string().describe('Comment text').optional(),
+  itemCondition: z.string().describe('Item condition').optional(),
+  returnDetails: z.string().describe('Return details').optional(),
+  returnReason: z.string().describe('Return reason').optional(),
+  receiptItem: ReceiptItemSchema.describe('Receipt item'),
+  otherProduct: z.custom<Product>().describe('Other product').optional(),
 });
 
 export type ReturnReceiptValues = z.infer<typeof ReturnReceiptValuesSchema>;
diff --git a/libs/oms/data-access/src/lib/schemas/shipping-type.schema.ts b/libs/oms/data-access/src/lib/schemas/shipping-type.schema.ts
new file mode 100644
index 000000000..69c45b31f
--- /dev/null
+++ b/libs/oms/data-access/src/lib/schemas/shipping-type.schema.ts
@@ -0,0 +1,17 @@
+import { z } from 'zod';
+
+export const ShippingType = {
+  NotSet: 0,
+  Parcel: 1,
+  Letter: 2,
+  Pallet: 4,
+  Freight: 8,
+  Digital: 16,
+  InStore: 32,
+  ClickAndCollect: 64,
+  Dropship: 128,
+} as const;
+
+export const ShippingTypeSchema = z.nativeEnum(ShippingType).describe('Shipping type');
+
+export type ShippingType = z.infer<typeof ShippingTypeSchema>;
diff --git a/libs/oms/data-access/src/lib/schemas/terms-of-delivery.schema.ts b/libs/oms/data-access/src/lib/schemas/terms-of-delivery.schema.ts
new file mode 100644
index 000000000..2b896e21b
--- /dev/null
+++ b/libs/oms/data-access/src/lib/schemas/terms-of-delivery.schema.ts
@@ -0,0 +1,18 @@
+import { PriceValueSchema, TouchBaseSchema } from '@isa/common/data-access';
+import { z } from 'zod';
+import { ShippingTypeSchema } from './shipping-type.schema';
+import { TypeOfDeliverySchema } from './type-of-delivery.schema';
+
+export const TermsOfDeliverySchema = z
+  .object({
+    isPartialShipping: z.boolean().describe('Whether partialShipping').optional(),
+    partialShippingCharge: z.number().describe('Partial shipping charge').optional(),
+    postage: PriceValueSchema.describe('Postage').optional(),
+    typeOfDelivery: TypeOfDeliverySchema.describe('Type of delivery').optional(),
+    shippingType: ShippingTypeSchema.describe('Shipping type').optional(),
+    shippingDeadlineStart: z.string().describe('Shipping deadline start').optional(),
+    shippingDeadlineEnd: z.string().describe('Shipping deadline end').optional(),
+  })
+  .extend(TouchBaseSchema.shape);
+
+export type TermsOfDelivery = z.infer<typeof TermsOfDeliverySchema>;
diff --git a/libs/oms/data-access/src/lib/schemas/type-of-delivery.schema.ts b/libs/oms/data-access/src/lib/schemas/type-of-delivery.schema.ts
new file mode 100644
index 000000000..3132c25b3
--- /dev/null
+++ b/libs/oms/data-access/src/lib/schemas/type-of-delivery.schema.ts
@@ -0,0 +1,16 @@
+import { z } from 'zod';
+
+export const TypeOfDelivery = {
+  NotSet: 0,
+  Standard: 1,
+  Express: 2,
+  SameDay: 4,
+  Pickup: 8,
+  Economy: 16,
+  Overnight: 32,
+  International: 64,
+} as const;
+
+export const TypeOfDeliverySchema = z.nativeEnum(TypeOfDelivery).describe('Type of delivery');
+
+export type TypeOfDelivery = z.infer<typeof TypeOfDeliverySchema>;
diff --git a/libs/oms/data-access/src/lib/services/index.ts b/libs/oms/data-access/src/lib/services/index.ts
index 318198666..c5e93e301 100644
--- a/libs/oms/data-access/src/lib/services/index.ts
+++ b/libs/oms/data-access/src/lib/services/index.ts
@@ -1,9 +1,10 @@
-export * from './logistician.service';
-export * from './order-creation.service';
-export * from './return-can-return.service';
-export * from './return-details.service';
-export * from './print-receipts.service';
-export * from './return-process.service';
-export * from './return-search.service';
-export * from './return-task-list.service';
-export * from './print-tolino-return-receipt.service';
+export * from './logistician.service';
+export * from './oms-metadata.service';
+export * from './order-creation.service';
+export * from './print-receipts.service';
+export * from './print-tolino-return-receipt.service';
+export * from './return-can-return.service';
+export * from './return-details.service';
+export * from './return-process.service';
+export * from './return-search.service';
+export * from './return-task-list.service';
diff --git a/libs/oms/data-access/src/lib/services/oms-metadata.service.ts b/libs/oms/data-access/src/lib/services/oms-metadata.service.ts
new file mode 100644
index 000000000..2b12a399b
--- /dev/null
+++ b/libs/oms/data-access/src/lib/services/oms-metadata.service.ts
@@ -0,0 +1,32 @@
+import { inject, Injectable } from '@angular/core';
+import { TabService, getMetadataHelper } from '@isa/core/tabs';
+import { DisplayOrder, DisplayOrderSchema } from '../schemas';
+import { OMS_DISPLAY_ORDERS_KEY } from '../constants';
+import z from 'zod';
+
+@Injectable({ providedIn: 'root' })
+export class OmsMetadataService {
+  #tabService = inject(TabService);
+
+  getDisplayOrders(tabId: number): DisplayOrder[] | undefined {
+    return getMetadataHelper(
+      tabId,
+      OMS_DISPLAY_ORDERS_KEY,
+      z.array(DisplayOrderSchema).optional(),
+      this.#tabService.entityMap(),
+    );
+  }
+
+  addDisplayOrders(tabId: number, orders: DisplayOrder[]) {
+    const existingOrders = this.getDisplayOrders(tabId) || [];
+    this.#tabService.patchTabMetadata(tabId, {
+      [OMS_DISPLAY_ORDERS_KEY]: [...existingOrders, ...orders],
+    });
+  }
+
+  clearDisplayOrders(tabId: number) {
+    this.#tabService.patchTabMetadata(tabId, {
+      [OMS_DISPLAY_ORDERS_KEY]: undefined,
+    });
+  }
+}
diff --git a/libs/oms/data-access/src/lib/stores/return-process.store.spec.ts b/libs/oms/data-access/src/lib/stores/return-process.store.spec.ts
index 602e074b5..5d37cfb27 100644
--- a/libs/oms/data-access/src/lib/stores/return-process.store.spec.ts
+++ b/libs/oms/data-access/src/lib/stores/return-process.store.spec.ts
@@ -5,7 +5,8 @@ import { TabService } from '@isa/core/tabs';
 import { patchState } from '@ngrx/signals';
 import { setAllEntities, setEntity } from '@ngrx/signals/entities';
 import { unprotected } from '@ngrx/signals/testing';
-import { Product, ReturnProcess } from '../models';
+import { Product } from '../schemas';
+import { ReturnProcess } from '../models';
 import { CreateReturnProcessError } from '../errors/return-process';
 import { ProductCategory } from '../questions';
 
diff --git a/libs/oms/feature/return-details/README.md b/libs/oms/feature/return-details/README.md
index 96485b38d..d0740b712 100644
--- a/libs/oms/feature/return-details/README.md
+++ b/libs/oms/feature/return-details/README.md
@@ -1,7 +1,1460 @@
-# oms-feature-return-details
+# @isa/oms/feature/return-details
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive Angular feature library for displaying receipt details and managing product returns in the Order Management System (OMS). Provides an interactive interface for viewing receipt information, selecting items for return, configuring return quantities and product categories, and initiating return processes.
 
-## Running unit tests
+## Overview
 
-Run `nx test oms-feature-return-details` to execute the unit tests.
+The Return Details feature library implements a sophisticated receipt visualization and return management interface. It displays detailed receipt information including customer data, order history, product items, and pricing. The library enables users to select items for return, specify quantities, categorize products, and validate return eligibility in real-time. It supports both primary receipt views and lazy-loaded customer receipt history for comprehensive return workflows.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [Component API Reference](#component-api-reference)
+- [Usage Examples](#usage-examples)
+- [Routing and Navigation](#routing-and-navigation)
+- [Architecture Notes](#architecture-notes)
+- [Dependencies](#dependencies)
+- [Testing](#testing)
+- [Best Practices](#best-practices)
+
+## Features
+
+- **Receipt Details Display** - Comprehensive receipt visualization with buyer, shipping, and order information
+- **Customer Receipt History** - Lazy-loaded customer purchase history based on email address
+- **Item Selection** - Interactive item selection with checkbox controls for return processing
+- **Quantity Management** - Dropdown-based quantity selection for partial returns
+- **Product Categorization** - Category selection for each return item (required for processing)
+- **Return Eligibility Validation** - Real-time validation of item return eligibility with API integration
+- **Expandable Sections** - Collapsible order details for improved UX and information density
+- **Customer Navigation** - Quick access to customer details, orders, and history
+- **Batch Operations** - Select/deselect all items in a receipt with single action
+- **Available Quantity Tracking** - Displays remaining returnable quantity (accounts for previous returns)
+- **Return Process Integration** - Seamless handoff to return process workflow with selected items
+- **E2E Testing Support** - Comprehensive `data-what` and `data-which` attributes throughout
+
+## Quick Start
+
+### 1. Import Routes
+
+```typescript
+import { Routes } from '@angular/router';
+
+export const routes: Routes = [
+  {
+    path: 'return-details',
+    loadChildren: () =>
+      import('@isa/oms/feature/return-details').then((m) => m.routes),
+  },
+];
+```
+
+### 2. Navigate to Receipt Details
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router, ActivatedRoute } from '@angular/router';
+
+@Component({
+  selector: 'app-return-search',
+  template: '...',
+})
+export class ReturnSearchComponent {
+  #router = inject(Router);
+  #route = inject(ActivatedRoute);
+
+  viewReceiptDetails(receiptId: number): void {
+    this.#router.navigate(['return-details', receiptId], {
+      relativeTo: this.#route,
+    });
+  }
+}
+```
+
+### 3. Component Usage in Custom Context
+
+```typescript
+import { Component } from '@angular/core';
+import { ReturnDetailsComponent } from '@isa/oms/feature/return-details';
+import { ReturnDetailsStore } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-custom-return-view',
+  template: `
+    <oms-feature-return-details></oms-feature-return-details>
+  `,
+  imports: [ReturnDetailsComponent],
+  providers: [ReturnDetailsStore], // Required for component state management
+})
+export class CustomReturnViewComponent {}
+```
+
+## Core Concepts
+
+### Return Details Store
+
+The library relies on `ReturnDetailsStore` from `@isa/oms/data-access` for state management. The store provides:
+
+- **Receipt entities** - Normalized receipt storage with entity management
+- **Item selection state** - Tracks selected item IDs across receipts
+- **Quantity mapping** - Maps item IDs to selected return quantities
+- **Category mapping** - Maps item IDs to selected product categories
+- **Return eligibility** - Caches and manages return eligibility checks
+- **Resources** - Provides reactive resources for receipt and eligibility data
+
+### Receipt Loading Strategy
+
+The library uses two loading strategies:
+
+1. **Static (Primary Receipt)** - Immediately loads the receipt specified in the URL route parameter (`receiptId`)
+2. **Lazy (Customer History)** - Loads additional customer receipts on-demand based on the buyer's email address
+
+This approach optimizes performance by loading only essential data initially, then expanding to show related receipts when available.
+
+### Item Return Eligibility
+
+Return eligibility is determined through multiple checks:
+
+1. **API Validation** - `canReturn` endpoint checks business rules
+2. **Category Selection** - Product category must be selected before return
+3. **Available Quantity** - Items with 0 available quantity cannot be returned
+4. **Receipt Item Actions** - Item metadata includes return eligibility flags
+
+The UI reflects these checks with disabled states, error messages, and loading indicators.
+
+### Product Categories
+
+Each return item must be categorized before processing. Available categories are provided by `ReturnDetailsService.availableCategories()`:
+
+```typescript
+const availableCategories: Array<{ key: ProductCategory; value: string }> = [
+  { key: ProductCategory.Book, value: 'Buch' },
+  { key: ProductCategory.Media, value: 'Medien' },
+  { key: ProductCategory.Other, value: 'Sonstiges' },
+  // ... additional categories
+];
+```
+
+### Return Process Initiation
+
+When users click "Rückgabe starten" (Start Return), the component:
+
+1. Groups selected items by receipt ID
+2. Collects selected quantities and categories for each item
+3. Passes data to `ReturnProcessStore` to initialize the return workflow
+4. Navigates to the return process route
+
+## Component API Reference
+
+### ReturnDetailsComponent (Main Component)
+
+The routed component that orchestrates the return details view.
+
+**Selector:** `oms-feature-return-details`
+
+**Route Parameter:**
+- `receiptId: number` - The ID of the receipt to display (parsed from route params)
+
+**Computed Properties:**
+
+- `receiptId(): number` - Parsed receipt ID from route parameters (throws if missing)
+- `canStartProcess(): boolean` - Returns true if items are selected and process ID exists
+
+**Resources:**
+
+- `receiptResource` - Reactive resource loading the primary receipt
+- `customerReceiptsResource` - Reactive resource loading customer's receipt history by email
+
+**Methods:**
+
+- `startProcess(): void` - Initiates the return process with selected items and navigates to process view
+
+**Navigation:**
+
+- Back button: Calls `location.back()` to return to previous view
+- Start return button: Navigates to `../../process` relative route
+
+**Example:**
+
+```typescript
+// Component handles route parameter automatically
+// Route: /return-details/12345
+// receiptId() === 12345
+
+// User clicks "Rückgabe starten"
+// Component groups items by receipt, navigates to process
+```
+
+### ReturnDetailsStaticComponent
+
+Displays the primary receipt details (non-expandable, always visible).
+
+**Selector:** `oms-feature-return-details-static`
+
+**Inputs:**
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| `receipt` | `Receipt` | Yes | The full receipt object to display |
+
+**Template Structure:**
+
+- Header with customer information and navigation
+- Expandable order details section
+- Order group toolbar (date, receipt number, select all)
+- List of receipt items with return controls
+
+**Example:**
+
+```typescript
+@Component({
+  template: `
+    <oms-feature-return-details-static
+      [receipt]="receipt()"
+    ></oms-feature-return-details-static>
+  `,
+})
+export class MyComponent {
+  receipt = signal<Receipt>({
+    id: 123,
+    receiptNumber: 'R-2024-00123',
+    printedDate: '2024-01-15T10:30:00Z',
+    items: [/* ... */],
+    buyer: {/* ... */},
+  });
+}
+```
+
+### ReturnDetailsLazyComponent
+
+Displays secondary receipts from customer history (expandable, lazy-loaded).
+
+**Selector:** `oms-feature-return-details-lazy`
+
+**Inputs:**
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| `receipt` | `ReceiptListItem` | Yes | Simplified receipt object from customer history |
+
+**Computed Properties:**
+
+- `receiptId(): number | undefined` - Returns receipt ID only when expanded (triggers lazy loading)
+
+**Resources:**
+
+- `receiptResource` - Loads full receipt details when expanded
+
+**Behavior:**
+
+- Renders collapsed by default (shows only order group toolbar)
+- Fetches full receipt data when user expands the section
+- Displays full item list and details once loaded
+
+**Example:**
+
+```typescript
+@Component({
+  template: `
+    @for (receipt of customerReceipts(); track receipt.id) {
+      <oms-feature-return-details-lazy
+        [receipt]="receipt"
+      ></oms-feature-return-details-lazy>
+    }
+  `,
+})
+export class MyComponent {
+  customerReceipts = signal<ReceiptListItem[]>([/* ... */]);
+}
+```
+
+### ReturnDetailsHeaderComponent
+
+Displays customer information with navigation menu.
+
+**Selector:** `oms-feature-return-details-header`
+
+**Inputs:**
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| `receiptId` | `number` | Yes | The receipt ID for store lookup |
+
+**Computed Properties:**
+
+- `receipt(): Receipt` - Full receipt from store
+- `buyer(): Buyer | undefined` - Buyer information from receipt
+- `referenceId(): number | undefined` - Customer reference ID for navigation
+- `name(): string` - Formatted customer name (handles individual and organization names)
+
+**Menu Actions:**
+
+- **Kundendetails** - Navigate to customer details page
+- **Bestellungen** - Navigate to customer orders page
+- **Historie** - Navigate to customer history page
+
+**E2E Attributes:**
+
+- `[data-what="button"][data-which="customer-actions"]` - Customer menu trigger
+- `[data-what="heading"][data-which="customer-name"]` - Customer name display
+- `[data-what="menu-item"][data-which="customer-details"]` - Menu items
+
+**Example:**
+
+```typescript
+@Component({
+  template: `
+    <oms-feature-return-details-header
+      [receiptId]="12345"
+    ></oms-feature-return-details-header>
+  `,
+})
+export class MyComponent {}
+```
+
+### ReturnDetailsOrderGroupComponent
+
+Displays receipt summary toolbar with item count, date, and batch selection.
+
+**Selector:** `oms-feature-return-details-order-group`
+
+**Inputs:**
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| `receipt` | `ReceiptInput` | Yes | Receipt with id, printedDate, receiptNumber, items |
+
+**Computed Properties:**
+
+- `receiptId(): number` - Receipt ID for store operations
+- `itemCount(): number` - Total number of items (handles both array and count)
+- `selectableItems(): ReceiptItem[]` - Items eligible for return selection
+- `allSelected(): boolean` - True if all selectable items are selected
+
+**Methods:**
+
+- `selectOrUnselectAll(): void` - Toggles selection state for all items in receipt
+
+**Behavior:**
+
+- Displays as expandable trigger when used with `uiExpandableTrigger` directive
+- Shows chevron icon when expandable context is available
+- Batch select/deselect button only visible when selectable items exist
+
+**Example:**
+
+```typescript
+@Component({
+  template: `
+    <ng-container uiExpandable>
+      <oms-feature-return-details-order-group
+        uiExpandableTrigger
+        [receipt]="receipt()"
+      ></oms-feature-return-details-order-group>
+
+      <div *uiExpanded>
+        <!-- Expanded content -->
+      </div>
+    </ng-container>
+  `,
+})
+export class MyComponent {
+  receipt = signal({
+    id: 123,
+    printedDate: '2024-01-15T10:30:00Z',
+    receiptNumber: 'R-2024-00123',
+    items: [/* ... */],
+  });
+}
+```
+
+### ReturnDetailsOrderGroupItemComponent
+
+Displays individual product item with pricing, details, and return status.
+
+**Selector:** `oms-feature-return-details-order-group-item`
+
+**Inputs:**
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| `item` | `ReceiptItem` | Yes | The receipt item with product details and pricing |
+
+**Computed Properties:**
+
+- `selected(): boolean` - Item selection state from store
+- `canReturn(): { result: boolean; message?: string }` - Return eligibility from API
+- `canReturnReceiptItem(): boolean` - Checks if item is in returnable items list
+- `canReturnMessage(): string` - Explanation message for return eligibility
+- `quantity(): number` - Original quantity from order
+- `availableQuantity(): number` - Remaining returnable quantity
+
+**Template Features:**
+
+- Product image with router link to product details
+- Product title, contributors, and pricing information
+- Product format icon and details (manufacturer, EAN, publication date)
+- Return controls (quantity, category, checkbox)
+- Warning messages for non-returnable items
+- Partial return notification
+
+**E2E Attributes:**
+
+- `[data-what="return-item-row"][data-which="<EAN>"]` - Item row container
+- `[data-what="product-image"][data-which="<EAN>"]` - Product image
+- `[data-what="product-name"][data-which="<EAN>"]` - Product name
+- `[data-what="product-price"][data-which="<EAN>"]` - Price display
+
+**Example:**
+
+```typescript
+@Component({
+  template: `
+    <oms-feature-return-details-order-group-item
+      [item]="receiptItem()"
+      class="border-b border-isa-neutral-300"
+    ></oms-feature-return-details-order-group-item>
+  `,
+})
+export class MyComponent {
+  receiptItem = signal<ReceiptItem>({
+    id: 456,
+    product: {
+      ean: '9783123456789',
+      name: 'Example Book',
+      contributors: 'John Author',
+      format: 'HC',
+      formatDetail: 'Hardcover',
+      manufacturer: 'Example Publisher',
+      publicationDate: '2024-01-01',
+    },
+    price: {
+      value: { value: 29.99, currency: 'EUR' },
+      vat: { inPercent: 7 },
+    },
+  });
+}
+```
+
+### ReturnDetailsOrderGroupItemControlsComponent
+
+Interactive controls for quantity selection, category assignment, and item selection.
+
+**Selector:** `oms-feature-return-details-order-group-item-controls`
+
+**Inputs:**
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| `item` | `ReceiptItem` | Yes | The receipt item for control configuration |
+
+**Computed Properties:**
+
+- `selected(): boolean` - Selection state from store
+- `selectedQuantity(): number` - Selected quantity from store
+- `quantityDropdownValues(): number[]` - Array of selectable quantities (1 to available)
+- `productCategory(): ProductCategory` - Selected category from store
+- `selectable(): boolean` - True if item can be selected (eligibility passed)
+- `canReturnReceiptItem(): boolean` - Return eligibility flag
+
+**Resources:**
+
+- `canReturnResource` - Reactive resource for return eligibility validation
+
+**Methods:**
+
+- `setProductCategory(category: ProductCategory): void` - Updates category in store
+- `setQuantity(quantity: number): void` - Updates quantity in store
+- `setSelected(selected: boolean): void` - Updates selection state in store
+
+**UI Elements:**
+
+- **Quantity Dropdown** - Only visible when available quantity > 1
+- **Category Dropdown** - Required for all returnable items
+- **Selection Checkbox** - Bullet-style checkbox for return selection
+- **Loading Spinner** - Displayed during eligibility validation
+
+**E2E Attributes:**
+
+- `[data-what="return-item-checkbox"][data-which="<EAN>"]` - Selection checkbox
+- `[data-what="load-spinner"][data-which="can-return"]` - Loading indicator
+
+**Example:**
+
+```typescript
+@Component({
+  template: `
+    <oms-feature-return-details-order-group-item-controls
+      [item]="receiptItem()"
+    ></oms-feature-return-details-order-group-item-controls>
+  `,
+})
+export class MyComponent {
+  receiptItem = signal<ReceiptItem>({
+    id: 456,
+    product: { ean: '9783123456789', /* ... */ },
+    /* ... */
+  });
+}
+```
+
+### ReturnDetailsDataComponent
+
+Displays minimal receipt metadata (date and type) in collapsed view.
+
+**Selector:** `oms-feature-return-details-data`
+
+**Inputs:**
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| `receipt` | `ReceiptInput` | Yes | Receipt with printedDate and receiptType |
+
+**Template Structure:**
+
+- Receipt date with time (formatted: `dd.MM.yyyy | HH:mm Uhr`)
+- Receipt type (translated to German)
+
+**Example:**
+
+```typescript
+@Component({
+  template: `
+    <oms-feature-return-details-data
+      *uiCollapsed
+      [receipt]="receipt()"
+    ></oms-feature-return-details-data>
+  `,
+})
+export class MyComponent {
+  receipt = signal({
+    printedDate: '2024-01-15T10:30:00Z',
+    receiptType: 'Invoice',
+  });
+}
+```
+
+### ReturnDetailsOrderGroupDataComponent
+
+Displays comprehensive receipt metadata including buyer and shipping information.
+
+**Selector:** `oms-feature-return-details-order-group-data`
+
+**Inputs:**
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| `receipt` | `ReceiptInput` | Yes | Receipt with buyer, shipping, order, printedDate, receiptType |
+
+**Computed Properties:**
+
+- `buyerName(): string` - Formatted buyer full name
+- `shippingName(): string` - Formatted shipping recipient full name
+
+**Template Structure:**
+
+- Receipt date and type
+- Order number (Vorgang-ID)
+- Order date
+- Buyer address (if available)
+- Shipping address (if available)
+
+**Example:**
+
+```typescript
+@Component({
+  template: `
+    <oms-feature-return-details-order-group-data
+      *uiExpanded
+      [receipt]="receipt()"
+    ></oms-feature-return-details-order-group-data>
+  `,
+})
+export class MyComponent {
+  receipt = signal<Receipt>({
+    printedDate: '2024-01-15T10:30:00Z',
+    receiptType: 'Invoice',
+    order: {
+      data: {
+        orderNumber: 'ORD-2024-00123',
+        orderDate: '2024-01-14T15:00:00Z',
+      },
+    },
+    buyer: {
+      firstName: 'John',
+      lastName: 'Doe',
+      address: {
+        street: 'Main St',
+        streetNumber: '123',
+        zipCode: '12345',
+        city: 'Berlin',
+      },
+    },
+    shipping: {
+      firstName: 'Jane',
+      lastName: 'Smith',
+      address: {
+        street: 'Second Ave',
+        streetNumber: '456',
+        zipCode: '54321',
+        city: 'Munich',
+      },
+    },
+  });
+}
+```
+
+## Usage Examples
+
+### Basic Receipt Details View
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-receipt-list',
+  template: `
+    <div class="receipt-list">
+      @for (receipt of receipts(); track receipt.id) {
+        <button
+          (click)="viewDetails(receipt.id)"
+          class="receipt-item"
+        >
+          {{ receipt.receiptNumber }} - {{ receipt.printedDate | date }}
+        </button>
+      }
+    </div>
+  `,
+})
+export class ReceiptListComponent {
+  #router = inject(Router);
+
+  receipts = signal([
+    { id: 101, receiptNumber: 'R-2024-00101', printedDate: '2024-01-15' },
+    { id: 102, receiptNumber: 'R-2024-00102', printedDate: '2024-01-16' },
+  ]);
+
+  viewDetails(receiptId: number): void {
+    // Navigate to return details with receipt ID
+    this.#router.navigate(['/oms/return-details', receiptId]);
+  }
+}
+```
+
+### Programmatic Item Selection
+
+```typescript
+import { Component, inject, effect } from '@angular/core';
+import { ReturnDetailsStore } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-auto-select-returns',
+  template: `
+    <oms-feature-return-details></oms-feature-return-details>
+  `,
+  providers: [ReturnDetailsStore],
+})
+export class AutoSelectReturnsComponent {
+  #store = inject(ReturnDetailsStore);
+
+  constructor() {
+    // Automatically select all eligible items when loaded
+    effect(() => {
+      const returnableItems = this.#store.returnableItems();
+      if (returnableItems.length > 0) {
+        const itemIds = returnableItems.map((item) => item.id);
+        this.#store.addSelectedItems(itemIds);
+      }
+    });
+  }
+}
+```
+
+### Custom Return Process Handler
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { ReturnDetailsStore, ReturnProcessStore } from '@isa/oms/data-access';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-custom-return-handler',
+  template: `
+    <oms-feature-return-details></oms-feature-return-details>
+
+    <button
+      uiButton
+      color="brand"
+      [disabled]="!canProcess()"
+      (click)="processReturn()"
+    >
+      Start Custom Return Process
+    </button>
+  `,
+  providers: [ReturnDetailsStore],
+})
+export class CustomReturnHandlerComponent {
+  #returnDetailsStore = inject(ReturnDetailsStore);
+  #returnProcessStore = inject(ReturnProcessStore);
+  #router = inject(Router);
+
+  canProcess = computed(() => {
+    const selectedItems = this.#returnDetailsStore.selectedItems();
+    const categories = this.#returnDetailsStore.itemCategoryMap();
+
+    // Ensure all selected items have categories
+    return selectedItems.every((item) =>
+      categories[item.id] !== ProductCategory.Unknown
+    );
+  });
+
+  processReturn(): void {
+    const selectedItems = this.#returnDetailsStore.selectedItems();
+    const quantities = this.#returnDetailsStore.selectedQuantityMap();
+    const categories = this.#returnDetailsStore.itemCategoryMap();
+    const receipts = this.#returnDetailsStore.receiptsEntityMap();
+
+    // Group items by receipt
+    const itemsByReceipt = groupBy(selectedItems, (item) => item.receipt?.id);
+
+    const returns = Object.entries(itemsByReceipt).map(([receiptId, items]) => ({
+      receipt: receipts[Number(receiptId)],
+      items: items.map((item) => ({
+        receiptItem: item,
+        quantity: quantities[item.id],
+        category: categories[item.id],
+      })),
+    }));
+
+    // Initialize custom return process
+    this.#returnProcessStore.startProcess({
+      processId: Date.now().toString(),
+      returns,
+    });
+
+    // Navigate to custom handler
+    this.#router.navigate(['/custom-return-process']);
+  }
+}
+```
+
+### Monitoring Return Eligibility
+
+```typescript
+import { Component, inject, effect } from '@angular/core';
+import { ReturnDetailsStore } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-eligibility-monitor',
+  template: `
+    <oms-feature-return-details></oms-feature-return-details>
+
+    <div class="eligibility-summary">
+      <p>Total Items: {{ totalItems() }}</p>
+      <p>Returnable: {{ returnableItems().length }}</p>
+      <p>Selected: {{ selectedItems().length }}</p>
+    </div>
+  `,
+  providers: [ReturnDetailsStore],
+})
+export class EligibilityMonitorComponent {
+  #store = inject(ReturnDetailsStore);
+
+  totalItems = computed(() => {
+    const items = this.#store.items();
+    return Object.keys(items).length;
+  });
+
+  returnableItems = this.#store.returnableItems;
+  selectedItems = this.#store.selectedItems;
+
+  constructor() {
+    // Log when eligibility changes
+    effect(() => {
+      const returnable = this.returnableItems();
+      console.log('Returnable items:', returnable.length);
+
+      returnable.forEach((item) => {
+        const canReturn = this.#store.getCanReturn(() => item)();
+        console.log(`Item ${item.id}:`, canReturn);
+      });
+    });
+  }
+}
+```
+
+### Filtering Customer Receipt History
+
+```typescript
+import { Component, computed, signal } from '@angular/core';
+import { ReturnDetailsLazyComponent } from '@isa/oms/feature/return-details';
+
+@Component({
+  selector: 'app-filtered-receipt-history',
+  template: `
+    <input
+      type="text"
+      [(ngModel)]="searchTerm"
+      placeholder="Filter receipts..."
+    />
+
+    @for (receipt of filteredReceipts(); track receipt.id) {
+      <oms-feature-return-details-lazy
+        [receipt]="receipt"
+      ></oms-feature-return-details-lazy>
+    }
+  `,
+  imports: [ReturnDetailsLazyComponent, FormsModule],
+})
+export class FilteredReceiptHistoryComponent {
+  searchTerm = signal('');
+  customerReceipts = signal<ReceiptListItem[]>([/* ... */]);
+
+  filteredReceipts = computed(() => {
+    const term = this.searchTerm().toLowerCase();
+    if (!term) return this.customerReceipts();
+
+    return this.customerReceipts().filter((receipt) =>
+      receipt.receiptNumber.toLowerCase().includes(term)
+    );
+  });
+}
+```
+
+## Routing and Navigation
+
+### Route Configuration
+
+The library exports a `routes` constant for lazy loading:
+
+```typescript
+// libs/oms/feature/return-details/src/lib/routes.ts
+import { Routes } from '@angular/router';
+import { ReturnDetailsComponent } from './return-details.component';
+
+export const routes: Routes = [
+  { path: ':receiptId', component: ReturnDetailsComponent }
+];
+```
+
+### Integration in Parent Routes
+
+```typescript
+// App routing configuration
+import { Routes } from '@angular/router';
+
+export const omsRoutes: Routes = [
+  {
+    path: 'oms',
+    children: [
+      {
+        path: 'return-details',
+        loadChildren: () =>
+          import('@isa/oms/feature/return-details').then((m) => m.routes),
+      },
+      {
+        path: 'process',
+        loadChildren: () =>
+          import('@isa/oms/feature/return-process').then((m) => m.routes),
+      },
+    ],
+  },
+];
+```
+
+### Navigation Patterns
+
+#### From Search Results
+
+```typescript
+// Navigate to receipt details from search
+this.#router.navigate(['/oms/return-details', receiptId]);
+```
+
+#### Back to Search
+
+```typescript
+// User clicks back button - uses Location.back()
+this.location.back();
+```
+
+#### To Return Process
+
+```typescript
+// After selecting items, navigate to process (relative navigation)
+this.#router.navigate(['../../', 'process'], {
+  relativeTo: this._activatedRoute,
+});
+// Resolves to: /oms/process (assuming current: /oms/return-details/123)
+```
+
+#### To Customer Details
+
+```typescript
+// From header menu, navigate to customer page
+const referenceId = 12345;
+const timestamp = Date.now();
+this.#router.navigate(['/kunde', timestamp, 'customer', 'search', referenceId]);
+```
+
+### Route Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `receiptId` | `number` | Yes | The ID of the receipt to display |
+
+**Parameter Parsing:**
+
+```typescript
+// Component automatically parses receiptId from route
+receiptId = computed<number>(() => {
+  const params = this.params();
+  if (params) {
+    return z.coerce.number().parse(params['receiptId']);
+  }
+  throw new Error('No receiptId found in route params');
+});
+```
+
+### Tab-Based Navigation
+
+The component uses `injectTabId()` from `@isa/core/tabs` for process identification:
+
+```typescript
+private processId = injectTabId();
+// Used to track return process across navigation
+```
+
+This enables multiple concurrent return processes in different browser tabs.
+
+## Architecture Notes
+
+### Component Hierarchy
+
+```
+ReturnDetailsComponent (Routed, provides ReturnDetailsStore)
+├── Back Button (Location.back())
+├── ReturnDetailsStaticComponent (Primary receipt, always visible)
+│   ├── ReturnDetailsHeaderComponent (Customer info + navigation menu)
+│   ├── Expandable Section
+│   │   ├── ReturnDetailsOrderGroupDataComponent (Expanded: full details)
+│   │   └── ReturnDetailsDataComponent (Collapsed: minimal info)
+│   ├── ReturnDetailsOrderGroupComponent (Toolbar: date, count, select all)
+│   └── ReturnDetailsOrderGroupItemComponent[] (Product items)
+│       └── ReturnDetailsOrderGroupItemControlsComponent (Quantity, category, checkbox)
+├── ProgressBar (While loading customer receipts)
+├── ReturnDetailsLazyComponent[] (Customer receipt history, lazy-loaded)
+│   ├── ReturnDetailsOrderGroupComponent (Expandable trigger)
+│   └── Expandable Section
+│       ├── ProgressBar (While loading full receipt)
+│       ├── ReturnDetailsOrderGroupDataComponent (Full details)
+│       └── ReturnDetailsOrderGroupItemComponent[] (Product items)
+└── Start Return Button (Fixed bottom-right, initiates process)
+```
+
+### State Management Architecture
+
+```
+ReturnDetailsStore (NgRx Signals)
+├── Receipt Entities (Normalized receipts by ID)
+├── Item Entities (Normalized items by ID)
+├── Selection State
+│   ├── selectedItemIds: Set<number>
+│   ├── selectedQuantityMap: Record<itemId, quantity>
+│   └── itemCategoryMap: Record<itemId, ProductCategory>
+├── Return Eligibility Cache
+│   └── canReturnResource(item) → { result: boolean, message?: string }
+└── Computed Values
+    ├── selectedItems(): ReceiptItem[]
+    ├── returnableItems(): ReceiptItem[]
+    └── availableQuantityMap(): Record<itemId, availableQty>
+```
+
+### Resource-Based Data Loading
+
+The library uses Angular's `resource()` API for reactive data fetching:
+
+```typescript
+// Primary receipt - loads immediately
+receiptResource = this.#store.receiptResource(this.receiptId);
+
+// Customer receipts - loads based on buyer email
+customerReceiptsResource = resource({
+  params: this.receiptResource.value,
+  loader: async ({ params, abortSignal }) => {
+    const email = params.buyer?.communicationDetails?.email;
+    if (!email) return [];
+
+    return await this.#returnDetailsService.fetchReceiptsByEmail(
+      { email },
+      abortSignal
+    );
+  },
+});
+
+// Lazy receipt - loads only when expanded
+receiptResource = this.#store.receiptResource(this.receiptId);
+// receiptId computed from expandable state
+```
+
+### Performance Optimizations
+
+1. **Lazy Loading** - Customer receipt history loads on-demand
+2. **Expandable Sections** - Full receipt details load only when expanded
+3. **OnPush Change Detection** - All components use `ChangeDetectionStrategy.OnPush`
+4. **Resource Caching** - Resources automatically cache and deduplicate requests
+5. **Computed Signals** - Efficient reactive computations with memoization
+6. **Track By** - Optimized `@for` loops with `track` expressions
+
+### Integration Points
+
+**Dependencies on OMS Data Access:**
+
+- `ReturnDetailsStore` - Primary state management
+- `ReturnProcessStore` - Return process orchestration
+- `ReturnDetailsService` - API integration
+- `ReceiptItem`, `Receipt`, `ReceiptListItem` - Data models
+- `canReturnReceiptItem()`, `getReceiptItemAction()` - Helper functions
+
+**Dependencies on Shared UI:**
+
+- `@isa/ui/buttons` - Button components
+- `@isa/ui/expandable` - Collapsible sections
+- `@isa/ui/input-controls` - Dropdowns and checkboxes
+- `@isa/ui/item-rows` - Product display layout
+- `@isa/ui/toolbar` - Receipt toolbar
+- `@isa/ui/progress-bar` - Loading indicators
+- `@isa/ui/menu` - Customer navigation menu
+
+**Dependencies on Shared Features:**
+
+- `@isa/shared/product-image` - Product image loading
+- `@isa/shared/product-router-link` - Product detail navigation
+
+### Known Architectural Considerations
+
+#### 1. Store Provider Scope (High Priority)
+
+**Current State:**
+- `ReturnDetailsStore` is provided at component level in `ReturnDetailsComponent`
+- Store state is scoped to the component instance
+- Navigation away destroys store state
+
+**Implication:**
+- Users cannot navigate back and preserve selection state
+- Multi-receipt workflows require reselection on return
+
+**Recommendation:**
+- Consider route-level provider for persistent state during session
+- Implement state restoration from session storage if needed
+
+#### 2. Customer Receipt Loading Strategy (Medium Priority)
+
+**Current State:**
+- All customer receipts load simultaneously after primary receipt
+- No pagination or incremental loading
+- Large receipt histories could impact performance
+
+**Recommendation:**
+- Implement virtual scrolling for receipt lists
+- Add pagination controls for customers with many receipts
+- Consider limiting initial load to recent receipts
+
+#### 3. Return Eligibility Validation Timing (Low Priority)
+
+**Current State:**
+- Eligibility checks trigger when category changes
+- Each category change triggers API call
+- No debouncing or batching
+
+**Potential Improvement:**
+- Batch eligibility checks for multiple items
+- Debounce category changes to reduce API calls
+- Pre-fetch eligibility for all items on load
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework (v20.1.2)
+- `@angular/router` - Routing and navigation
+- `@angular/common` - Common Angular utilities (DatePipe, Location, etc.)
+- `@angular/forms` - FormsModule for ngModel
+- `@isa/oms/data-access` - OMS data access layer and state management
+- `@isa/core/tabs` - Tab ID management
+- `@isa/core/logging` - Logging service
+- `@isa/ui/buttons` - Button components
+- `@isa/ui/expandable` - Expandable section directives
+- `@isa/ui/input-controls` - Input components (checkbox, dropdown)
+- `@isa/ui/item-rows` - Item display layout
+- `@isa/ui/toolbar` - Toolbar component
+- `@isa/ui/progress-bar` - Progress indicators
+- `@isa/ui/menu` - Menu components
+- `@isa/shared/product-image` - Product image directive
+- `@isa/shared/product-router-link` - Product navigation
+- `@isa/icons` - Icon library
+- `@ng-icons/core` - Icon rendering
+- `zod` - Schema validation
+- `lodash` - Utility functions (groupBy)
+
+### Path Alias
+
+Import from: `@isa/oms/feature/return-details`
+
+### Peer Dependencies
+
+The library requires the following services to be available through dependency injection:
+
+- `ReturnDetailsStore` (must be provided at component or route level)
+- `ReturnProcessStore` (for return process integration)
+- `ReturnDetailsService` (from `@isa/oms/data-access`)
+
+## Testing
+
+The library uses **Jest** with **Spectator** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test oms-feature-return-details --skip-nx-cache
+
+# Run tests with coverage
+npx nx test oms-feature-return-details --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test oms-feature-return-details --watch
+```
+
+### Test Structure
+
+The library includes unit tests for key components:
+
+- **ReturnDetailsHeaderComponent** - Customer information and navigation menu
+- **ReturnDetailsOrderGroupItemControlsComponent** - Item control interactions
+
+### Example Test (ReturnDetailsHeaderComponent)
+
+```typescript
+import { createComponentFactory, Spectator } from '@ngneat/spectator/jest';
+import { ReturnDetailsHeaderComponent } from './return-details-header.component';
+import { ReturnDetailsStore } from '@isa/oms/data-access';
+import { signal } from '@angular/core';
+
+describe('ReturnDetailsHeaderComponent', () => {
+  let spectator: Spectator<ReturnDetailsHeaderComponent>;
+
+  const createComponent = createComponentFactory({
+    component: ReturnDetailsHeaderComponent,
+  });
+
+  const getReceiptMock = signal<Receipt>({
+    id: 12345,
+    items: [],
+    buyer: {
+      reference: { id: 12345 },
+      firstName: 'John',
+      lastName: 'Doe',
+      buyerNumber: '123456',
+    },
+  });
+
+  const storeMock = {
+    getReceipt: () => getReceiptMock,
+  };
+
+  beforeEach(() => {
+    spectator = createComponent({
+      props: {
+        receiptId: 12345,
+      },
+      providers: [
+        {
+          provide: ReturnDetailsStore,
+          useValue: storeMock,
+        },
+      ],
+    });
+  });
+
+  it('should create', () => {
+    expect(spectator.component).toBeTruthy();
+  });
+
+  describe('[data-what="button"][data-which="customer-actions"]', () => {
+    it('should be disabled if referenceId() returns undefined', () => {
+      jest.spyOn(spectator.component, 'referenceId').mockReturnValue(undefined);
+      spectator.detectComponentChanges();
+
+      const button = spectator.query(
+        '[data-what="button"][data-which="customer-actions"]'
+      );
+
+      expect(button).toBeTruthy();
+      expect(button).toBeDisabled();
+    });
+
+    it('should be enabled if referenceId() returns a value', () => {
+      jest.spyOn(spectator.component, 'referenceId').mockReturnValue(12345);
+      spectator.detectComponentChanges();
+
+      const button = spectator.query(
+        '[data-what="button"][data-which="customer-actions"]'
+      );
+
+      expect(button).toBeTruthy();
+      expect(button).not.toBeDisabled();
+    });
+  });
+});
+```
+
+### Testing Best Practices
+
+1. **Mock ReturnDetailsStore** - Always provide mock store in tests
+2. **Test E2E Attributes** - Verify `data-what` and `data-which` attributes exist
+3. **Test User Interactions** - Verify click handlers, form inputs, navigation
+4. **Test Computed Properties** - Ensure reactive computations work correctly
+5. **Test Error States** - Verify error messages and disabled states
+6. **Test Loading States** - Verify progress indicators during data fetching
+
+### E2E Testing Support
+
+All interactive elements include `data-what` and `data-which` attributes for automated testing:
+
+```typescript
+// Product item row
+<ui-item-row data-what="return-item-row" [attr.data-which]="item.product.ean">
+
+// Selection checkbox
+<input
+  type="checkbox"
+  data-what="return-item-checkbox"
+  [attr.data-which]="item().product.ean"
+/>
+
+// Customer actions button
+<button
+  data-what="button"
+  data-which="customer-actions"
+>
+
+// Menu items
+<a data-what="menu-item" data-which="customer-details">
+```
+
+## Best Practices
+
+### State Management
+
+**Do:**
+
+```typescript
+// Use store for all selection state
+this.#store.addSelectedItems([itemId]);
+this.#store.setQuantity(itemId, quantity);
+this.#store.setProductCategory(itemId, category);
+```
+
+**Don't:**
+
+```typescript
+// Don't manage selection state locally
+this.selectedItems.push(item); // ❌ Wrong
+```
+
+### Component Inputs
+
+**Do:**
+
+```typescript
+// Use required inputs with proper typing
+item = input.required<ReceiptItem>();
+receipt = input.required<Receipt>();
+```
+
+**Don't:**
+
+```typescript
+// Don't use optional inputs when data is required
+@Input() item?: ReceiptItem; // ❌ Old pattern
+```
+
+### Resource Loading
+
+**Do:**
+
+```typescript
+// Use resources for async data with proper error handling
+customerReceiptsResource = resource({
+  params: this.receiptResource.value,
+  loader: async ({ params, abortSignal }) => {
+    try {
+      return await this.service.fetch(params, abortSignal);
+    } catch (error) {
+      this.#logger.error('Failed to fetch', error);
+      return [];
+    }
+  },
+});
+```
+
+**Don't:**
+
+```typescript
+// Don't use manual subscription management
+ngOnInit() {
+  this.service.fetch().subscribe(data => {
+    this.receipts = data; // ❌ Old pattern
+  });
+}
+```
+
+### Expandable Sections
+
+**Do:**
+
+```typescript
+// Use expandable directives correctly
+<ng-container uiExpandable #expandable="uiExpandable">
+  <div uiExpandableTrigger>Click to expand</div>
+  <div *uiExpanded>Expanded content</div>
+  <div *uiCollapsed>Collapsed content</div>
+</ng-container>
+```
+
+**Don't:**
+
+```typescript
+// Don't mix expandable patterns
+<div uiExpandable *uiExpanded> // ❌ Wrong nesting
+```
+
+### Navigation
+
+**Do:**
+
+```typescript
+// Use relative navigation for known routes
+this.#router.navigate(['../../process'], {
+  relativeTo: this._activatedRoute,
+});
+
+// Use Location.back() for browser back
+this.location.back();
+```
+
+**Don't:**
+
+```typescript
+// Don't use hardcoded absolute paths
+this.#router.navigate(['/oms/return/process']); // ❌ Brittle
+```
+
+### E2E Attributes
+
+**Do:**
+
+```typescript
+// Always include data-what and data-which for interactive elements
+<button
+  data-what="button"
+  data-which="start-return"
+  (click)="startProcess()"
+>
+
+// Use dynamic data-which for item-specific elements
+<div
+  data-what="product-item"
+  [attr.data-which]="item.product.ean"
+>
+```
+
+**Don't:**
+
+```typescript
+// Don't omit E2E attributes
+<button (click)="startProcess()"> // ❌ Missing attributes
+```
+
+### Logging
+
+**Do:**
+
+```typescript
+// Use logger with context
+#logger = logger(() => ({
+  component: 'ReturnDetailsComponent',
+  receiptId: this.receiptId(),
+}));
+
+this.#logger.error('Failed to load receipt', error);
+```
+
+**Don't:**
+
+```typescript
+// Don't use console.log
+console.log('Error:', error); // ❌ No context, no production logging
+```
+
+### Error Handling
+
+**Do:**
+
+```typescript
+// Handle errors gracefully with fallbacks
+try {
+  return await this.service.fetch(email, abortSignal);
+} catch (error) {
+  this.#logger.error('Failed to fetch customer receipts', error);
+  return []; // Return empty array as fallback
+}
+```
+
+**Don't:**
+
+```typescript
+// Don't let errors propagate unhandled
+return await this.service.fetch(email); // ❌ No error handling
+```
+
+### Performance
+
+**Do:**
+
+```typescript
+// Use OnPush change detection
+@Component({
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+
+// Use track expressions in @for loops
+@for (item of items(); track item.id) {
+  <app-item [item]="item"></app-item>
+}
+
+// Lazy load expensive operations
+receiptId = computed(() => {
+  if (!this.expandable().expanded()) return undefined;
+  return this.receipt().id;
+});
+```
+
+**Don't:**
+
+```typescript
+// Don't use default change detection
+@Component({
+  changeDetection: ChangeDetectionStrategy.Default, // ❌
+})
+
+// Don't use @for without track
+@for (item of items()) { // ❌ Poor performance
+```
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/oms/feature/return-process/README.md b/libs/oms/feature/return-process/README.md
index ccde5d015..e6577319b 100644
--- a/libs/oms/feature/return-process/README.md
+++ b/libs/oms/feature/return-process/README.md
@@ -1,7 +1,1541 @@
-# oms-feature-return-process
+# @isa/oms/feature/return-process
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive Angular feature library for managing product returns with dynamic question flows, validation, and backend integration. Part of the Order Management System (OMS) domain.
 
-## Running unit tests
+## Overview
 
-Run `nx test oms-feature-return-process` to execute the unit tests.
+The Return Process feature library provides a complete workflow for processing product returns in a retail environment. It handles complex question flows based on product categories (books, electronics, Tolino devices, etc.), validates user input in real-time, checks return eligibility through both frontend and backend validation, and guides users through the entire return journey from initial selection to final confirmation.
+
+The library integrates with the OMS data-access layer for state management and business logic, leverages NgRx Signals for reactive state updates, and provides a type-safe, schema-validated approach to collecting return information.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Components](#core-components)
+- [Question System Architecture](#question-system-architecture)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Routing and Navigation](#routing-and-navigation)
+- [State Management](#state-management)
+- [Validation and Eligibility](#validation-and-eligibility)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+- [Dependencies](#dependencies)
+
+## Features
+
+- **Dynamic Question Flows** - Category-specific questions for books, electronics, Tolino devices, and more
+- **Five Question Types** - Select (chips), Product (EAN search), Checklist (multi-select), Info (display), and Group (nested questions)
+- **Real-time Validation** - Frontend and backend validation with immediate feedback
+- **Progress Tracking** - Visual progress bar showing question completion status
+- **Eligibility Checking** - Automatic determination of return eligibility based on answers
+- **Barcode Scanning** - Integrated scanner support for product identification
+- **Type-safe State** - Zod schema validation for all user inputs
+- **Automatic Navigation** - Conditional routing based on process completion
+- **Session Persistence** - Answers preserved across browser sessions via IndexedDB
+- **Responsive Design** - Tailwind CSS with ISA design system integration
+
+## Quick Start
+
+### 1. Add Routes to Your Application
+
+```typescript
+import { Route } from '@angular/router';
+
+export const routes: Route[] = [
+  {
+    path: 'return-process/:id',
+    loadChildren: () =>
+      import('@isa/oms/feature/return-process').then((m) => m.routes),
+  },
+];
+```
+
+### 2. Initialize a Return Process
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { ReturnProcessStore } from '@isa/oms/data-access';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-receipt-selection',
+  template: '...'
+})
+export class ReceiptSelectionComponent {
+  #returnProcessStore = inject(ReturnProcessStore);
+  #router = inject(Router);
+
+  async startReturn(receipt: Receipt, items: ReceiptItem[]): Promise<void> {
+    const processId = Date.now(); // Unique process ID
+
+    // Initialize the return process
+    this.#returnProcessStore.startProcess({
+      processId,
+      returns: [
+        {
+          receipt,
+          items: items.map(item => ({
+            receiptItem: item,
+            quantity: 1,
+            category: 'Buch/Kalender' // Product category
+          }))
+        }
+      ]
+    });
+
+    // Navigate to return process
+    await this.#router.navigate(['/return-process', processId]);
+  }
+}
+```
+
+### 3. The Library Handles the Rest
+
+Once initialized, the library automatically:
+- Displays appropriate questions based on product category
+- Validates answers using Zod schemas
+- Checks eligibility with backend API
+- Shows progress and conditional navigation
+- Persists state across sessions
+
+## Core Components
+
+### ReturnProcessComponent
+
+Main orchestrator component that manages the overall return process workflow.
+
+**Selector:** `oms-feature-return-process`
+
+**Key Responsibilities:**
+- Displays all return process items for a given process ID
+- Manages navigation (back button, continue to summary)
+- Aggregates eligibility across all items
+- Validates completion before allowing navigation
+
+**Inputs:** None (uses route parameter via `injectTabId()`)
+
+**Outputs:** None (navigation-based)
+
+**Template Features:**
+- Back navigation button
+- Header with instructions
+- List of return process items
+- Conditional "Continue" button (only shows when all items are eligible)
+
+**Example Usage:**
+```typescript
+// Automatically rendered via routing
+// Route: /return-process/:id
+```
+
+### ReturnProcessItemComponent
+
+Displays a single return process item with product info, questions, and eligibility status.
+
+**Selector:** `oms-feature-return-process-item`
+
+**Inputs:**
+- `returnProcessId: number` (required) - The unique identifier for the return process
+
+**Key Features:**
+- Product information display
+- Question renderer integration
+- Progress bar visualization
+- Eligibility status indicators (checkmark/error with message)
+- Loading spinner during backend validation
+
+**Eligibility States:**
+- **Eligible** - Green checkmark with "Artikel bereit für Rückgabe"
+- **Not Eligible** - Red X with specific error message
+- **Unknown** - Loading spinner during validation
+
+**Example:**
+```html
+<oms-feature-return-process-item
+  [returnProcessId]="123">
+</oms-feature-return-process-item>
+```
+
+### ReturnProcessQuestionsComponent
+
+Container component that fetches and passes questions to the renderer.
+
+**Selector:** `oms-feature-return-process-questions`
+
+**Inputs:**
+- `returnProcessId: number` (required) - The return process identifier
+
+**Key Responsibilities:**
+- Retrieves active questions from ReturnProcessService
+- Filters questions based on product category
+- Passes questions to renderer for display
+
+**Example:**
+```html
+<oms-feature-return-process-questions
+  [returnProcessId]="processId">
+</oms-feature-return-process-questions>
+```
+
+### ReturnProcessQuestionsRendererComponent
+
+Recursive renderer that displays questions dynamically based on their type.
+
+**Selector:** `oms-feature-return-process-questions-renderer`
+
+**Inputs:**
+- `returnProcessId: number` (required) - The return process identifier
+- `questions: ReturnProcessQuestion[]` (required) - Array of questions to render
+
+**Supported Question Types:**
+1. **Select** - Single-choice chip selection
+2. **Product** - EAN input with scanner integration
+3. **Checklist** - Multi-select with optional text field
+4. **Info** - Display-only informational content
+5. **Group** - Nested questions (recursive rendering)
+
+**Example:**
+```html
+<oms-feature-return-process-questions-renderer
+  [returnProcessId]="123"
+  [questions]="activeQuestions">
+</oms-feature-return-process-questions-renderer>
+```
+
+### Question Type Components
+
+#### ReturnProcessSelectQuestionComponent
+
+Single-choice question using chip UI components.
+
+**Selector:** `oms-feature-return-process-select-question`
+
+**Inputs:**
+- `returnProcessId: number` (required)
+- `question: ReturnProcessSelectQuestion` (required)
+
+**Features:**
+- Reactive form control with validation
+- Automatic answer persistence to store
+- Answer removal when invalid
+
+**Example:**
+```html
+<oms-feature-return-process-select-question
+  [returnProcessId]="123"
+  [question]="selectQuestion">
+</oms-feature-return-process-select-question>
+```
+
+#### ReturnProcessProductQuestionComponent
+
+Product lookup question with EAN input and barcode scanning.
+
+**Selector:** `oms-feature-return-process-product-question`
+
+**Inputs:**
+- `returnProcessId: number` (required)
+- `question: ReturnProcessProductQuestion` (required)
+
+**Features:**
+- EAN validation with custom validator
+- Barcode scanner integration
+- Product search via CatalogueSearchService
+- Product preview with image and details
+- Error states (not found, invalid EAN)
+- Auto-focus on input field
+
+**States:**
+- **Empty** - Input field with "Check" button
+- **Fetching** - Loading spinner on button
+- **Found** - Product display with clear button
+- **Not Found** - Error message "Kein Artikel gefunden"
+- **Invalid** - Error message "Die eingegebene EAN ist ungültig"
+
+**Example:**
+```html
+<oms-feature-return-process-product-question
+  [returnProcessId]="123"
+  [question]="productQuestion">
+</oms-feature-return-process-product-question>
+```
+
+#### ReturnProcessChecklistQuestionComponent
+
+Multi-select checklist with optional "other" text field.
+
+**Selector:** `oms-feature-return-process-checklist-question`
+
+**Inputs:**
+- `returnProcessId: number` (required)
+- `question: ReturnProcessChecklistQuestion` (required)
+
+**Features:**
+- Multiple option selection via checkboxes
+- Optional textarea for "other" input
+- Linked signals for reactive updates
+- Zod schema validation
+- Deep equality checking with lodash
+
+**Answer Structure:**
+```typescript
+{
+  options?: string[],  // Selected checkbox values
+  other?: string       // Optional text input
+}
+```
+
+**Example:**
+```html
+<oms-feature-return-process-checklist-question
+  [returnProcessId]="123"
+  [question]="checklistQuestion">
+</oms-feature-return-process-checklist-question>
+```
+
+#### ReturnProcessInfoQuestionComponent
+
+Display-only informational question (no user input).
+
+**Selector:** `oms-feature-return-process-info-question`
+
+**Inputs:**
+- `question: ReturnProcessInfoQuestion` (required)
+
+**Features:**
+- Displays description and content list
+- No answer collection
+- Always considered "answered"
+
+**Example:**
+```html
+<oms-feature-return-process-info-question
+  [question]="infoQuestion">
+</oms-feature-return-process-info-question>
+```
+
+## Question System Architecture
+
+### Product Categories
+
+The question system supports six product categories, each with tailored question flows:
+
+```typescript
+const ProductCategory = {
+  Unknown: 'unknown',
+  BookCalendar: 'Buch/Kalender',
+  TonDatentraeger: 'Ton-/Datenträger',
+  SpielwarenPuzzle: 'Spielwaren/Puzzle',
+  SonstigesNonbook: 'Sonstiges und Non-Book',
+  ElektronischeGeraete: 'Andere Elektronische Geräte',
+  Tolino: 'Tolino',
+};
+```
+
+### Question Types
+
+Five distinct question types handle different input scenarios:
+
+```typescript
+const ReturnProcessQuestionType = {
+  Select: 'select',       // Single choice (chips)
+  Product: 'product',     // EAN lookup
+  Checklist: 'checklist', // Multi-select
+  Info: 'info',           // Display only
+  Group: 'group',         // Nested questions
+};
+```
+
+### Question Structure
+
+#### Select Question Example
+
+```typescript
+{
+  key: 'item-condition',
+  description: 'Wie ist der Artikelzustand?',
+  type: 'select',
+  options: [
+    {
+      label: 'Neuwertig/Originalverpackt',
+      value: 'Originalverpackt',
+      nextQuestion: 'return-reason',
+      returnInfo: { itemCondition: 'Neuwertig/Originalverpackt' }
+    },
+    {
+      label: 'Beschädigt/Fehldruck',
+      value: 'Geöffnet/Defekt',
+      returnInfo: { itemCondition: 'Beschädigt/Fehldruck' }
+    }
+  ]
+}
+```
+
+#### Product Question Example
+
+```typescript
+{
+  key: 'delivered-item',
+  description: 'Welcher Artikel wurde geliefert?',
+  type: 'product',
+  nextQuestion: 'item-damaged' // Optional next question
+}
+```
+
+#### Checklist Question Example
+
+```typescript
+{
+  key: 'package-missing-items',
+  description: 'Was fehlt?',
+  type: 'checklist',
+  options: [
+    { label: 'Karton / Umverpackung', value: 'Karton / Umverpackung' },
+    { label: 'Ladekabel', value: 'Ladekabel' },
+    { label: 'Quickstart-Guide', value: 'Quickstart-Guide' }
+  ],
+  other: {
+    label: 'Sonstiges'
+  }
+}
+```
+
+#### Group Question Example (Nested)
+
+```typescript
+{
+  key: 'package-complete-group',
+  type: 'group',
+  questions: [
+    {
+      key: 'package-incomplete-info',
+      description: 'Fehlende Teile',
+      type: 'info',
+      content: ['Item 1', 'Item 2']
+    },
+    {
+      key: 'package-missing-items',
+      description: 'Was fehlt?',
+      type: 'checklist',
+      options: [...]
+    }
+  ]
+}
+```
+
+### Question Flow and Branching
+
+Questions support conditional branching via the `nextQuestion` property:
+
+```typescript
+// Question 1: Item Condition
+{
+  key: 'item-condition',
+  type: 'select',
+  options: [
+    {
+      value: 'Originalverpackt',
+      nextQuestion: 'return-reason', // Branch to return reason
+    },
+    {
+      value: 'Geöffnet/Defekt',
+      // No nextQuestion - ends flow
+    }
+  ]
+}
+
+// Question 2: Return Reason (shown only if OVP selected)
+{
+  key: 'return-reason',
+  type: 'select',
+  options: [
+    {
+      value: 'Gefällt nicht/Widerruf',
+      // Ends flow
+    },
+    {
+      value: 'Fehllieferung',
+      nextQuestion: 'delivered-item', // Branch to product lookup
+    }
+  ]
+}
+
+// Question 3: Delivered Item (shown only if wrong item)
+{
+  key: 'delivered-item',
+  type: 'product',
+  description: 'Welcher Artikel wurde geliefert?'
+}
+```
+
+### Active Question Determination
+
+The `ReturnProcessService.activeReturnProcessQuestions()` method:
+
+1. **Starts with all category questions** from `CategoryQuestions` registry
+2. **Filters based on previous answers** using `nextQuestion` logic
+3. **Validates answers** using Zod schemas
+4. **Returns only questions that should be shown** based on user choices
+5. **Detects cyclic dependencies** and throws errors
+
+**Example Flow:**
+
+```typescript
+// User selects "Originalverpackt" for item-condition
+answers = { 'item-condition': 'Originalverpackt' };
+
+// Active questions: ['item-condition', 'return-reason']
+// ('return-reason' shown because option has nextQuestion)
+
+// User selects "Fehllieferung" for return-reason
+answers = {
+  'item-condition': 'Originalverpackt',
+  'return-reason': 'Fehllieferung'
+};
+
+// Active questions: ['item-condition', 'return-reason', 'delivered-item']
+// ('delivered-item' shown because 'Fehllieferung' option has nextQuestion)
+```
+
+### Category Question Registry
+
+Questions are organized by category in the `CategoryQuestions` registry (from `@isa/oms/data-access`):
+
+```typescript
+const CategoryQuestions: Record<ProductCategory, ReturnProcessQuestion[]> = {
+  'Buch/Kalender': bookCalendarQuestions,
+  'Ton-/Datenträger': tonDatentraegerQuestions,
+  'Spielwaren/Puzzle': nonbookQuestions,
+  'Sonstiges und Non-Book': nonbookQuestions,
+  'Andere Elektronische Geräte': elektronischeGeraeteQuestions,
+  'Tolino': tolinoQuestions,
+  'unknown': []
+};
+```
+
+## API Reference
+
+### ReturnProcessComponent
+
+**Selector:** `oms-feature-return-process`
+
+**Inputs:** None (uses route parameter)
+
+**Computed Signals:**
+- `processId: Signal<number | null>` - The current process ID from route
+- `returnProcesses: Signal<ReturnProcess[]>` - Filtered processes for current ID
+- `canContinueToSummary: Signal<boolean>` - True when all questions answered and eligible
+- `canReturn: WritableSignal<boolean>` - Backend validation result for all processes
+
+**Methods:**
+None (template-driven navigation)
+
+**Template Actions:**
+- `location.back()` - Navigate to previous page
+
+### ReturnProcessItemComponent
+
+**Selector:** `oms-feature-return-process-item`
+
+**Inputs:**
+- `returnProcessId: number` (required) - Unique return process identifier
+
+**Computed Signals:**
+- `returnProcess: Signal<ReturnProcess | undefined>` - The current process entity
+- `progress: Signal<{ answered: number; total: number } | undefined>` - Question progress
+- `eligibleForReturn: Signal<EligibleForReturn | undefined>` - Frontend eligibility check
+- `eligibleForReturnState: Signal<EligibleForReturnState>` - Combined frontend/backend state
+- `eligibleForReturnMessage: Signal<string | undefined>` - Eligibility explanation message
+
+**Writable Signals:**
+- `canReturn: WritableSignal<CanReturn | undefined>` - Backend validation result
+
+**Lifecycle:**
+- **Constructor Effect** - Automatically validates eligibility on process changes
+
+### ReturnProcessQuestionsComponent
+
+**Selector:** `oms-feature-return-process-questions`
+
+**Inputs:**
+- `returnProcessId: number` (required) - Return process identifier
+
+**Computed Signals:**
+- `returnProcess: Signal<ReturnProcess | undefined>` - Current process
+- `questions: Signal<ReturnProcessQuestion[]>` - Active questions for display
+
+### ReturnProcessSelectQuestionComponent
+
+**Selector:** `oms-feature-return-process-select-question`
+
+**Inputs:**
+- `returnProcessId: number` (required)
+- `question: ReturnProcessSelectQuestion` (required)
+
+**Form Control:**
+- `control: FormControl<string | undefined>` - Reactive form control with required validation
+
+**Lifecycle:**
+- **Constructor** - Sets up value change subscription and answer synchronization
+
+### ReturnProcessProductQuestionComponent
+
+**Selector:** `oms-feature-return-process-product-question`
+
+**Inputs:**
+- `returnProcessId: number` (required)
+- `question: ReturnProcessProductQuestion` (required)
+
+**Form Control:**
+- `control: FormControl<string>` - EAN input with validation (required + EAN format)
+
+**Signals:**
+- `product: WritableSignal<Product | undefined>` - Found product data
+- `status: WritableSignal<{ fetching: boolean; hasResult?: boolean }>` - Search status
+
+**Methods:**
+- `check(): void` - Validates EAN and searches for product
+- `resetProduct(): void` - Clears product and answer
+- `onScan(value: string | null): void` - Handles barcode scanner input
+
+**RxJS Methods:**
+- `check: RxMethod<void>` - Observable-based product search with error handling
+
+### ReturnProcessChecklistQuestionComponent
+
+**Selector:** `oms-feature-return-process-checklist-question`
+
+**Inputs:**
+- `returnProcessId: number` (required)
+- `question: ReturnProcessChecklistQuestion` (required)
+
+**Computed Signals:**
+- `currentAnswer: Signal<ReturnProcessChecklistAnswer>` - Current answer from store
+
+**Linked Signals:**
+- `options: LinkedSignal<string[] | undefined>` - Selected checkbox values
+- `other: LinkedSignal<string | undefined>` - Optional text input
+
+**Methods:**
+- `updateAnswer(answer: ReturnProcessChecklistAnswer): void` - Persists answer to store
+
+**Effects:**
+- `valueChangesEffect` - Watches signal changes and updates store
+
+### ReturnProcessInfoQuestionComponent
+
+**Selector:** `oms-feature-return-process-info-question`
+
+**Inputs:**
+- `question: ReturnProcessInfoQuestion` (required)
+
+**No Methods or Signals** (Display-only component)
+
+## Usage Examples
+
+### Complete Return Process Flow
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router } from '@angular/router';
+import { ReturnProcessStore, Receipt, ReceiptItem } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-return-workflow',
+  template: `
+    <button (click)="startReturnProcess()">
+      Start Return
+    </button>
+  `
+})
+export class ReturnWorkflowComponent {
+  #returnProcessStore = inject(ReturnProcessStore);
+  #router = inject(Router);
+
+  async startReturnProcess(): Promise<void> {
+    // Sample data
+    const receipt: Receipt = {
+      id: 12345,
+      printedDate: '2024-01-15',
+      // ... other receipt properties
+    };
+
+    const items: ReceiptItem[] = [
+      {
+        id: 1,
+        product: {
+          ean: '9783123456789',
+          name: 'Sample Book',
+          category: 'Buch/Kalender'
+        },
+        quantity: 1,
+        // ... other item properties
+      }
+    ];
+
+    // Generate unique process ID (typically tab ID or timestamp)
+    const processId = Date.now();
+
+    try {
+      // Initialize return process in store
+      this.#returnProcessStore.startProcess({
+        processId,
+        returns: [
+          {
+            receipt,
+            items: items.map(item => ({
+              receiptItem: item,
+              quantity: 1,
+              category: 'Buch/Kalender'
+            }))
+          }
+        ]
+      });
+
+      // Navigate to return process page
+      await this.#router.navigate(['/return-process', processId]);
+    } catch (error) {
+      console.error('Failed to start return process:', error);
+    }
+  }
+}
+```
+
+### Accessing Return Process State
+
+```typescript
+import { Component, computed, inject } from '@angular/core';
+import { ReturnProcessStore, ReturnProcessService } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-process-monitor',
+  template: `
+    <div>
+      <h3>Return Process Status</h3>
+      <p>Total Processes: {{ processCount() }}</p>
+      <p>Completed: {{ completedCount() }}</p>
+
+      @for (process of processes(); track process.id) {
+        <div>
+          <p>Process {{ process.id }}</p>
+          <p>Progress: {{ getProgress(process) }}</p>
+          <p>Eligible: {{ isEligible(process) }}</p>
+        </div>
+      }
+    </div>
+  `
+})
+export class ProcessMonitorComponent {
+  #returnProcessStore = inject(ReturnProcessStore);
+  #returnProcessService = inject(ReturnProcessService);
+
+  processes = this.#returnProcessStore.entities;
+
+  processCount = computed(() => this.processes().length);
+
+  completedCount = computed(() => {
+    return this.processes().filter(p => {
+      const progress = this.#returnProcessService
+        .returnProcessQuestionsProgress(p);
+      return progress?.answered === progress?.total;
+    }).length;
+  });
+
+  getProgress(process: ReturnProcess): string {
+    const progress = this.#returnProcessService
+      .returnProcessQuestionsProgress(process);
+    if (!progress) return 'N/A';
+    return `${progress.answered}/${progress.total}`;
+  }
+
+  isEligible(process: ReturnProcess): boolean {
+    const result = this.#returnProcessService.eligibleForReturn(process);
+    return result?.state === 'eligible';
+  }
+}
+```
+
+### Programmatic Answer Setting
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { ReturnProcessStore } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-auto-answer',
+  template: '...'
+})
+export class AutoAnswerComponent {
+  #returnProcessStore = inject(ReturnProcessStore);
+
+  autoFillAnswers(processId: number): void {
+    // Set select answer
+    this.#returnProcessStore.setAnswer(
+      processId,
+      'item-condition',
+      'Originalverpackt'
+    );
+
+    // Set checklist answer
+    this.#returnProcessStore.setAnswer(
+      processId,
+      'package-missing-items',
+      {
+        options: ['Ladekabel', 'Quickstart-Guide'],
+        other: 'Custom missing item'
+      }
+    );
+
+    // Set product answer
+    this.#returnProcessStore.setAnswer(
+      processId,
+      'delivered-item',
+      {
+        ean: '9783123456789',
+        name: 'Sample Product',
+        catalogProductNumber: '12345',
+        // ... other product properties
+      }
+    );
+
+    // Remove answer
+    this.#returnProcessStore.removeAnswer(
+      processId,
+      'item-condition'
+    );
+  }
+}
+```
+
+### Testing Question Eligibility
+
+```typescript
+import { Component, inject, signal } from '@angular/core';
+import {
+  ReturnProcessService,
+  ReturnProcess,
+  EligibleForReturnState
+} from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-eligibility-check',
+  template: `
+    <div>
+      <h3>Eligibility Status</h3>
+      @if (eligibility(); as result) {
+        @switch (result.state) {
+          @case ('eligible') {
+            <p class="text-green-600">✓ Eligible for return</p>
+          }
+          @case ('not-eligible') {
+            <p class="text-red-600">✗ Not eligible: {{ result.reason }}</p>
+          }
+          @case ('unknown') {
+            <p class="text-gray-600">⏳ Checking eligibility...</p>
+          }
+        }
+      }
+    </div>
+  `
+})
+export class EligibilityCheckComponent {
+  #returnProcessService = inject(ReturnProcessService);
+
+  process = signal<ReturnProcess>({
+    id: 1,
+    processId: 100,
+    receiptId: 12345,
+    productCategory: 'Tolino',
+    quantity: 1,
+    receiptDate: '2024-01-15',
+    receiptItem: { /* ... */ },
+    answers: {
+      'item-condition': 'Originalverpackt',
+      'return-reason': 'Gefällt nicht/Widerruf',
+      'display-damaged': 'Nein',
+      'device-power': 'Ja'
+    }
+  });
+
+  eligibility = computed(() => {
+    return this.#returnProcessService.eligibleForReturn(this.process());
+  });
+}
+```
+
+## Routing and Navigation
+
+### Route Configuration
+
+The library exports a `routes` array that defines three routes:
+
+```typescript
+// libs/oms/feature/return-process/src/lib/routes.ts
+
+export const routes: Route[] = [
+  {
+    path: '',
+    component: ReturnProcessComponent
+  },
+  {
+    path: 'summary',
+    loadChildren: () =>
+      import('@isa/oms/feature/return-summary').then((feat) => feat.routes)
+  },
+  {
+    path: 'review',
+    loadChildren: () =>
+      import('@isa/oms/feature/return-review').then((feat) => feat.routes)
+  }
+];
+```
+
+### Integration in Main App
+
+```typescript
+// apps/isa-app/src/app/app-routing.module.ts
+
+import { Route } from '@angular/router';
+
+export const routes: Route[] = [
+  {
+    path: 'return-process/:id',
+    loadChildren: () =>
+      import('@isa/oms/feature/return-process').then((m) => m.routes)
+  },
+  // ... other routes
+];
+```
+
+### Navigation Flow
+
+1. **Start** - External component navigates to `/return-process/:id`
+2. **Questions** - User answers questions on main route (`/return-process/:id`)
+3. **Summary** - Click "Weiter" navigates to `/return-process/:id/summary`
+4. **Review** - Additional route for final review at `/return-process/:id/review`
+
+### Process ID Management
+
+The library uses `injectTabId()` from `@isa/core/tabs` to retrieve the process ID:
+
+```typescript
+// In ReturnProcessComponent
+processId = injectTabId(); // Returns Signal<number | null>
+```
+
+This integrates with the tab system to support multiple concurrent return processes.
+
+### Navigation Guards
+
+The "Weiter" (Continue) button is conditionally displayed:
+
+```html
+@if (canContinueToSummary() && canReturn()) {
+  <div class="text-right">
+    <a routerLink="summary" uiButton color="brand">
+      Weiter
+    </a>
+  </div>
+}
+```
+
+**Conditions for Navigation:**
+1. All processes must exist
+2. All questions must be answered
+3. Frontend eligibility must be "eligible"
+4. Backend validation must pass
+
+## State Management
+
+### ReturnProcessStore Integration
+
+The library uses `ReturnProcessStore` from `@isa/oms/data-access` for state management:
+
+**Store Features:**
+- **Entity Management** - Stores `ReturnProcess` entities with normalized structure
+- **Session Persistence** - Automatically persists to IndexedDB via `IDBStorageProvider`
+- **Computed Next ID** - Generates unique IDs for new processes
+- **Answer Management** - Methods for setting/removing answers
+- **Orphan Cleanup** - Automatically removes entities when tabs close
+
+**Key Methods:**
+
+```typescript
+// Start new return process
+ReturnProcessStore.startProcess(params: StartProcess): void
+
+// Set answer for a question
+ReturnProcessStore.setAnswer<T>(id: number, question: string, answer: T): void
+
+// Remove answer
+ReturnProcessStore.removeAnswer(id: number, question: string): void
+
+// Remove processes by ID
+ReturnProcessStore.removeAllEntitiesByProcessId(...processIds: number[]): void
+
+// Access entities
+ReturnProcessStore.entities: Signal<ReturnProcess[]>
+ReturnProcessStore.entityMap: Signal<Record<number, ReturnProcess>>
+```
+
+### Answer Structure
+
+Answers are stored as a key-value map with question keys:
+
+```typescript
+interface ReturnProcess {
+  id: number;
+  processId: number;
+  receiptId: number;
+  receiptItem: ReceiptItem;
+  receiptDate: string | undefined;
+  productCategory: string;
+  quantity: number;
+  answers: Record<string, unknown>; // Question answers
+  returnReceipt?: Receipt; // Set when process completed
+}
+```
+
+**Example Answer Data:**
+
+```typescript
+{
+  'item-condition': 'Originalverpackt',
+  'return-reason': 'Fehllieferung',
+  'delivered-item': {
+    ean: '9783123456789',
+    name: 'Sample Book',
+    catalogProductNumber: '12345'
+  },
+  'package-missing-items': {
+    options: ['Ladekabel'],
+    other: 'Custom item'
+  }
+}
+```
+
+### State Synchronization
+
+Components use Angular signals and effects for reactive state updates:
+
+```typescript
+// Example from ReturnProcessSelectQuestionComponent
+constructor() {
+  // Listen to form changes and update store
+  this.control.valueChanges
+    .pipe(takeUntilDestroyed())
+    .subscribe((value) => {
+      if (this.control.valid) {
+        this.#returnProcessStore.setAnswer(
+          this.returnProcessId(),
+          this.question().key,
+          value
+        );
+      } else {
+        this.#returnProcessStore.removeAnswer(
+          this.returnProcessId(),
+          this.question().key
+        );
+      }
+    });
+
+  // Sync store changes back to form
+  effect(() => {
+    const value = this.#returnProcessStore
+      .entityMap()[this.returnProcessId()]
+      ?.answers[this.question().key];
+    if (value !== this.control.value) {
+      this.control.setValue(value as string);
+    }
+  });
+}
+```
+
+### Session Persistence
+
+All return process data is automatically persisted to IndexedDB:
+
+- **Automatic Save** - Every `setAnswer()` and `removeAnswer()` triggers `saveToStorage()`
+- **Restore on Load** - State automatically restored when user returns
+- **Tab Cleanup** - Orphaned processes removed via `onInit` hook
+
+**Storage Provider:**
+
+```typescript
+withStorage('return-process', IDBStorageProvider)
+```
+
+## Validation and Eligibility
+
+### Frontend Validation (Schema-Based)
+
+All answers are validated using Zod schemas (defined in `@isa/oms/data-access`):
+
+```typescript
+// Example schemas
+const ReturnProcessQuestionSchema = {
+  'item-condition': z.enum(['Originalverpackt', 'Geöffnet/Defekt']),
+  'return-reason': z.enum(['Gefällt nicht/Widerruf', 'Fehllieferung']),
+  'display-damaged': z.enum(['Ja', 'Nein']),
+  'delivered-item': z.object({
+    ean: z.string(),
+    name: z.string(),
+    catalogProductNumber: z.string().optional(),
+    // ... more fields
+  }).passthrough(),
+  'package-missing-items': z.object({
+    options: z.array(z.enum([...])).min(1).optional(),
+    other: z.string().optional()
+  })
+};
+```
+
+### Form-Level Validation
+
+Individual question components use reactive forms with validators:
+
+```typescript
+// Select Question - Required validator
+control = new FormControl<string | undefined>(undefined, [
+  Validators.required
+]);
+
+// Product Question - EAN validator
+control = new FormControl<string>('', [
+  Validators.required,
+  eanValidator // Custom EAN format validator from @isa/utils/ean-validation
+]);
+```
+
+### Eligibility Determination
+
+Eligibility is checked at two levels:
+
+#### 1. Frontend Eligibility (ReturnProcessService)
+
+```typescript
+eligibleForReturn(returnProcess: ReturnProcess): EligibleForReturn | undefined {
+  // Returns undefined if questions not answered
+  // Returns { state, reason } based on category-specific logic
+
+  switch (returnProcess.productCategory) {
+    case 'Andere Elektronische Geräte':
+      return isElektronischeGeraeteEligibleForReturn(returnProcess, questions);
+    case 'Ton-/Datenträger':
+      return isTonDatentraegerEligibleForReturn(returnProcess, questions);
+    case 'Tolino':
+      return isTolinoEligibleForReturn(returnProcess, questions);
+    default:
+      return { state: 'eligible' };
+  }
+}
+```
+
+**Eligibility States:**
+
+```typescript
+const EligibleForReturnState = {
+  NotEligible: 'not-eligible',
+  Eligible: 'eligible',
+  Unknown: 'unknown'
+};
+```
+
+**Example Category Logic (Tolino):**
+
+```typescript
+// Not eligible if display damaged
+if (answers['display-damaged'] === 'Ja') {
+  return {
+    state: 'not-eligible',
+    reason: 'Display beschädigt - Rückgabe nicht möglich'
+  };
+}
+
+// Not eligible if device doesn't power on
+if (answers['device-power'] === 'Nein') {
+  return {
+    state: 'not-eligible',
+    reason: 'Gerät schaltet nicht ein - Rückgabe nicht möglich'
+  };
+}
+
+// Eligible if all checks pass
+return { state: 'eligible' };
+```
+
+#### 2. Backend Validation (ReturnCanReturnService)
+
+```typescript
+// In ReturnProcessItemComponent
+constructor() {
+  effect(() => {
+    const returnProcess = this.returnProcess();
+
+    untracked(async () => {
+      if (returnProcess) {
+        this.canReturn.set(undefined);
+        try {
+          const canReturnResponse = await this.#returnCanReturnService
+            .canReturn(returnProcess);
+          this.canReturn.set(canReturnResponse);
+        } catch (error) {
+          this.#logger.error('Failed to validate return process', error);
+          this.canReturn.set(undefined);
+        }
+      }
+    });
+  });
+}
+```
+
+**Backend Response:**
+
+```typescript
+interface CanReturn {
+  result: boolean;      // Can return or not
+  message?: string;     // Explanation message
+}
+```
+
+### Combined Eligibility Logic
+
+The final eligibility state combines frontend and backend validation:
+
+```typescript
+eligibleForReturnState = computed(() => {
+  const frontendEligible = this.eligibleForReturn()?.state;
+  const backendCanReturn = this.canReturn()?.result;
+
+  // Still validating
+  if (backendCanReturn === undefined) {
+    return 'unknown';
+  }
+
+  // Both must be true for eligibility
+  if (backendCanReturn === true && frontendEligible === 'eligible') {
+    return 'eligible';
+  }
+
+  return 'not-eligible';
+});
+```
+
+### Progress Calculation
+
+Question progress is calculated considering nested questions:
+
+```typescript
+returnProcessQuestionsProgress(returnProcess: ReturnProcess) {
+  const questions = getReturnProcessQuestions(returnProcess);
+  const activeQuestions = this.activeReturnProcessQuestions(returnProcess);
+
+  // Count answered questions (including group sub-questions)
+  const answered = activeQuestions.reduce((acc, q) => {
+    if (q.type === 'group') {
+      return acc + q.questions.filter(
+        subQ => subQ.key in returnProcess.answers
+      ).length;
+    }
+    return q.key in returnProcess.answers ? acc + 1 : acc;
+  }, 0);
+
+  // Calculate total possible questions (longest path)
+  const total = calculateLongestQuestionDepth(questions, returnProcess.answers);
+
+  return { answered, total };
+}
+```
+
+## Testing
+
+The library uses **Jest** for testing (migration to Vitest pending).
+
+### Running Tests
+
+```bash
+# Run all tests for this library
+npx nx test oms-feature-return-process --skip-nx-cache
+
+# Run with coverage
+npx nx test oms-feature-return-process --code-coverage --skip-nx-cache
+
+# Run in watch mode
+npx nx test oms-feature-return-process --watch
+```
+
+### Test Structure
+
+Current test coverage includes:
+
+- **Component Tests** - Basic component instantiation and template rendering
+- **Integration Tests** - Component interactions with stores and services
+- **E2E Attributes** - Verification of `data-what` and `data-which` attributes
+
+### Example Test
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { ReturnProcessComponent } from './return-process.component';
+
+describe('ReturnProcessComponent', () => {
+  let component: ReturnProcessComponent;
+  let fixture: ComponentFixture<ReturnProcessComponent>;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      imports: [ReturnProcessComponent],
+      providers: [
+        // Mock providers
+      ]
+    }).compileComponents();
+
+    fixture = TestBed.createComponent(ReturnProcessComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+
+  it('should have E2E attribute on back button', () => {
+    const backButton = fixture.nativeElement.querySelector('[data-what="back-navigation"]');
+    expect(backButton).toBeTruthy();
+  });
+});
+```
+
+### E2E Testing Attributes
+
+All interactive elements include E2E testing attributes:
+
+```html
+<!-- Back navigation -->
+<button data-what="back-navigation" (click)="location.back()">
+  zurück
+</button>
+
+<!-- Summary navigation -->
+<a data-what="summary-navigation" routerLink="summary">
+  Weiter
+</a>
+
+<!-- Loading spinner -->
+<ui-icon-button
+  data-what="load-spinner"
+  data-which="can-return"
+  [pending]="true">
+</ui-icon-button>
+```
+
+### Testing Best Practices
+
+1. **Mock Dependencies** - Use TestBed to provide mock services
+2. **Verify E2E Attributes** - Always test presence of `data-what` and `data-which`
+3. **Test User Flows** - Simulate complete question flows
+4. **Validate State Changes** - Ensure store updates correctly
+5. **Test Error States** - Verify error handling and display
+
+## Architecture Notes
+
+### Component Hierarchy
+
+```
+ReturnProcessComponent (Main orchestrator)
+└── ReturnProcessItemComponent (Per-item wrapper)
+    ├── ReturnProductInfoComponent (Product display)
+    └── ReturnProcessQuestionsComponent (Question container)
+        └── ReturnProcessQuestionsRendererComponent (Recursive renderer)
+            ├── ReturnProcessSelectQuestionComponent
+            ├── ReturnProcessProductQuestionComponent
+            ├── ReturnProcessChecklistQuestionComponent
+            ├── ReturnProcessInfoQuestionComponent
+            └── ReturnProcessQuestionsRendererComponent (Recursive for groups)
+```
+
+### Data Flow
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     User Interaction                        │
+└────────────────────────┬────────────────────────────────────┘
+                         │
+                         ▼
+┌─────────────────────────────────────────────────────────────┐
+│              Question Component (e.g., Select)              │
+│  - FormControl validation                                   │
+│  - User input collection                                    │
+└────────────────────────┬────────────────────────────────────┘
+                         │
+                         ▼
+┌─────────────────────────────────────────────────────────────┐
+│                  ReturnProcessStore                         │
+│  - setAnswer(id, key, value)                               │
+│  - Persist to IndexedDB                                     │
+└────────────────────────┬────────────────────────────────────┘
+                         │
+                         ▼
+┌─────────────────────────────────────────────────────────────┐
+│               ReturnProcessService                          │
+│  - activeReturnProcessQuestions() → Filter visible Qs      │
+│  - eligibleForReturn() → Frontend validation               │
+│  - returnProcessQuestionsProgress() → Progress calc        │
+└────────────────────────┬────────────────────────────────────┘
+                         │
+                         ▼
+┌─────────────────────────────────────────────────────────────┐
+│             ReturnCanReturnService (Backend)                │
+│  - canReturn() → Backend validation via API                │
+└────────────────────────┬────────────────────────────────────┘
+                         │
+                         ▼
+┌─────────────────────────────────────────────────────────────┐
+│                 Component Signals Update                    │
+│  - eligibleForReturnState                                   │
+│  - canContinueToSummary                                     │
+│  - progress                                                 │
+└─────────────────────────────────────────────────────────────┘
+                         │
+                         ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    UI Re-renders                            │
+│  - Show/hide questions                                      │
+│  - Update progress bar                                      │
+│  - Enable/disable navigation                                │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Design Patterns
+
+1. **Presenter Pattern** - Components are thin presenters, business logic in services
+2. **Reactive State** - Signals and computed values for automatic UI updates
+3. **Recursive Rendering** - Question renderer supports nested question groups
+4. **Strategy Pattern** - Different question types use different rendering strategies
+5. **Command Pattern** - Store methods (`setAnswer`, `removeAnswer`) encapsulate actions
+6. **Observer Pattern** - Effects watch signals and trigger side effects
+
+### Key Architectural Decisions
+
+#### 1. Two-Level Validation
+
+**Decision:** Implement both frontend and backend validation
+
+**Rationale:**
+- Frontend validation provides immediate feedback
+- Backend validation ensures business rules and data integrity
+- Combined approach prevents invalid returns while maintaining UX
+
+**Trade-off:** Additional complexity and API calls, but improved reliability
+
+#### 2. Recursive Question Rendering
+
+**Decision:** Use recursive component for nested question groups
+
+**Rationale:**
+- Tolino category requires nested questions (Group type)
+- Recursive rendering handles arbitrary nesting depth
+- Single renderer component reduces code duplication
+
+**Trade-off:** Slightly more complex than flat rendering, but handles all cases
+
+#### 3. Signal-Based State Management
+
+**Decision:** Use Angular signals instead of RxJS observables for local state
+
+**Rationale:**
+- Simpler mental model for component state
+- Automatic change detection without manual subscriptions
+- Better performance with fine-grained reactivity
+
+**Trade-off:** Mixing signals and observables can be confusing
+
+#### 4. Session Persistence via IndexedDB
+
+**Decision:** Persist all return process data to IndexedDB
+
+**Rationale:**
+- Preserve user progress across browser sessions
+- Handle page refreshes gracefully
+- Support multi-tab workflows
+
+**Trade-off:** Storage size limitations, async complexity
+
+### Known Limitations
+
+1. **No Undo/Redo** - Once answered, questions can only be re-answered, not undone
+2. **Linear Question Flow** - Questions follow a tree structure, no arbitrary jumps
+3. **Single Product Category** - Each process item has one category, no mixing
+4. **Backend Dependency** - Cannot complete process without backend validation
+5. **No Draft Saving** - Process must be completed or abandoned, no "save for later"
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Answer History** - Track answer changes for audit trail
+2. **Conditional Validation** - More complex validation rules based on multiple answers
+3. **Question Templates** - Reusable question patterns across categories
+4. **Multi-step Progress** - Show step-by-step progress instead of single bar
+5. **Answer Pre-fill** - Automatically suggest answers based on previous returns
+6. **Offline Support** - Queue backend validation for later when offline
+7. **Migration to Vitest** - Update testing framework to match newer libraries
+
+## Dependencies
+
+### Required Angular Libraries
+
+- `@angular/core` ^20.1.2 - Angular framework
+- `@angular/common` ^20.1.2 - Common Angular directives
+- `@angular/forms` ^20.1.2 - Reactive forms
+- `@angular/router` ^20.1.2 - Routing and navigation
+
+### Required Internal Libraries
+
+#### OMS Domain
+- `@isa/oms/data-access` - Core business logic, stores, and services
+- `@isa/oms/shared/product-info` - Product information display component
+
+#### UI Components
+- `@isa/ui/buttons` - Button and icon button components
+- `@isa/ui/input-controls` - Form controls (chips, checkbox, textarea, text field)
+- `@isa/ui/progress-bar` - Progress visualization
+
+#### Shared Components
+- `@isa/shared/scanner` - Barcode scanner integration
+- `@isa/shared/product-image` - Product image directive
+- `@isa/shared/product-router-link` - Product navigation directive
+
+#### Core Utilities
+- `@isa/core/tabs` - Tab management and process ID injection
+- `@isa/core/logging` - Centralized logging service
+- `@isa/icons` - Icon library
+
+#### Catalogue
+- `@isa/catalogue/data-access` - Product search service
+
+#### Utilities
+- `@isa/utils/ean-validation` - EAN format validation
+
+### External Dependencies
+
+- `@ngrx/signals` ^18.1.2 - Signal-based state management
+- `@ngrx/operators` ^18.1.2 - RxJS operators for NgRx
+- `@ng-icons/core` ^30.3.0 - Icon components
+- `zod` ^3.24.1 - Schema validation
+- `rxjs` ^7.8.1 - Reactive programming
+- `lodash` ^4.17.21 - Utility functions (isEqual)
+
+### Generated API Clients
+
+- `@generated/swagger/oms-api` - OMS API client for backend communication
+
+### Path Alias
+
+Import from: `@isa/oms/feature/return-process`
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/oms/feature/return-review/README.md b/libs/oms/feature/return-review/README.md
index 7464fa487..524944b4d 100644
--- a/libs/oms/feature/return-review/README.md
+++ b/libs/oms/feature/return-review/README.md
@@ -1,7 +1,1804 @@
-# return-review
+# @isa/oms/feature/return-review
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive Angular feature library for reviewing completed return processes in the Order Management System (OMS). Provides a confirmation interface for successful returns with task review capabilities and receipt printing functionality.
 
-## Running unit tests
+## Overview
 
-Run `nx test return-review` to execute the unit tests.
+The Return Review feature library implements the final step in the return process workflow, displaying a success confirmation and allowing users to review all tasks (completed and pending) associated with the return. It provides a read-only task list view with the ability to reprint return confirmation receipts, serving as both a completion confirmation and a reference point for return operations.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [Component API Reference](#component-api-reference)
+- [Usage Examples](#usage-examples)
+- [Routing and Navigation](#routing-and-navigation)
+- [Architecture Notes](#architecture-notes)
+- [Dependencies](#dependencies)
+- [Testing](#testing)
+- [Best Practices](#best-practices)
+
+## Features
+
+- **Success Confirmation** - Clear visual confirmation of successful return completion
+- **Receipt Reprinting** - One-click reprint of return confirmation receipts
+- **Complete Task Review** - Display all tasks (completed and pending) in review mode
+- **Navigation Protection** - Guard against leaving with uncompleted tasks
+- **Tab-Based Isolation** - Process ID derived from tab context for multi-tab support
+- **Integration with Task List** - Leverages shared task list component in review appearance
+- **Print Service Integration** - Automatic batch printing of all return receipts for the process
+- **Clean UI Design** - Minimal, focused interface emphasizing completion status
+- **E2E Testing Support** - Comprehensive `data-what` and `data-which` attributes
+
+## Quick Start
+
+### 1. Import Routes
+
+```typescript
+import { Routes } from '@angular/router';
+
+export const routes: Routes = [
+  {
+    path: 'return-review',
+    loadChildren: () =>
+      import('@isa/oms/feature/return-review').then((m) => m.routes),
+  },
+];
+```
+
+### 2. Navigate to Review
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-return-process',
+  template: '...',
+})
+export class ReturnProcessComponent {
+  #router = inject(Router);
+
+  completeReturn(): void {
+    // After completing return process
+    this.#router.navigate(['/return-review']);
+  }
+}
+```
+
+### 3. Basic Usage
+
+The component is automatically loaded via routing and requires no configuration:
+
+```typescript
+// Route automatically loads the component
+// Component uses tab context for process ID
+// Task list automatically fetches and displays all tasks
+```
+
+## Core Concepts
+
+### Return Review Workflow
+
+The return review represents the final step in the return process:
+
+1. **Return Process Completion** - User completes all required return process steps
+2. **Navigation to Review** - System navigates to return review route
+3. **Success Confirmation** - User sees "Die Rückgabe war erfolgreich!" message
+4. **Task Review** - All tasks (completed and pending) displayed in table layout
+5. **Receipt Printing** - Optional reprint of return confirmation receipts
+6. **Task Completion** - User completes any remaining pending tasks
+7. **Navigation Away** - Guard checks for uncompleted tasks before allowing exit
+
+### Process ID and Tab Context
+
+The library uses `injectTabId()` from `@isa/core/tabs` to derive the process ID:
+
+```typescript
+processId = injectTabId();  // Returns Signal<number | undefined>
+```
+
+**Benefits:**
+- Multiple return processes can run simultaneously in different tabs
+- Each tab maintains independent state
+- No manual process ID management required
+- Process ID automatically propagates to child components
+
+### Task List Integration
+
+The review component delegates task display to `ReturnTaskListComponent`:
+
+```html
+<oms-shared-return-task-list
+  [appearance]="'review'"
+></oms-shared-return-task-list>
+```
+
+**Key Behaviors:**
+- **Appearance Mode**: `'review'` shows all tasks (completed and pending)
+- **Layout**: Table-based grid layout optimized for scanning
+- **Read-Only**: Tasks can be marked as completed but not modified
+- **Automatic Fetching**: Component fetches tasks on initialization
+
+### Receipt Printing
+
+The component provides receipt reprinting functionality:
+
+```typescript
+async printReceipt() {
+  const processId = this.processId();
+  if (processId) {
+    // 1. Fetch all return processes for this process ID
+    const receiptIds = this.#returnProcessStore
+      .entities()
+      .filter((p) => p.processId === processId && p.returnReceipt?.id)
+      .map((p) => p.returnReceipt!.id);
+
+    // 2. Print all receipts in batch
+    await this.#printReceiptsService.printReturnReceipts({
+      returnReceiptIds: receiptIds,
+    });
+  }
+}
+```
+
+**Features:**
+- Batch printing of all return receipts for the process
+- Filters out processes without return receipt IDs
+- Handles printing failures gracefully
+- No user feedback required (print service handles UI)
+
+### Navigation Guard
+
+The library includes `UncompletedTasksGuard` to prevent accidental navigation away from pending tasks:
+
+```typescript
+canDeactivate(): boolean | Promise<boolean> {
+  const hasUncompletedTasks = this.uncompletedTaskListItems().length > 0;
+
+  if (!hasUncompletedTasks) {
+    return true;  // Allow navigation
+  }
+
+  return this.openDialog();  // Confirm with user
+}
+```
+
+**Dialog Behavior:**
+- **Title**: "Aufgaben erledigen"
+- **Message**: "Bitte schließen Sie die Aufgaben ab bevor Sie das die Rückgabe verlassen"
+- **Close Button**: "Verlassen" (allows navigation)
+- **Confirm Button**: "Zurück" (stays on page)
+- **Logic**: Confirmation = stay, close/cancel = leave
+
+## Component API Reference
+
+### ReturnReviewComponent
+
+Main component orchestrating the review interface.
+
+**Selector:** `oms-feature-return-review`
+
+**Inputs:** None (uses injected services and tab context)
+
+**Outputs:** None (internal actions only)
+
+**Template Structure:**
+```html
+<oms-feature-return-review-header
+  (printReceipt)="printReceipt()"
+></oms-feature-return-review-header>
+
+<oms-shared-return-task-list
+  [appearance]="'review'"
+></oms-shared-return-task-list>
+```
+
+**Injected Services:**
+- `PrintReceiptsService` - Receipt printing operations
+- `ReturnProcessStore` - Access to return process entities
+
+**Computed Properties:**
+- `processId: Signal<number | undefined>` - Derived from tab context via `injectTabId()`
+
+**Methods:**
+
+##### `printReceipt(): Promise<void>`
+
+Reprints all return confirmation receipts for the current process.
+
+**Behavior:**
+1. Retrieves current process ID from tab context
+2. Filters return processes by process ID
+3. Extracts return receipt IDs from processes
+4. Calls print service with batch of receipt IDs
+
+**Error Handling:**
+- Print service handles errors internally
+- No explicit error UI in component
+- Failures logged by print service
+
+**Example:**
+```typescript
+// Triggered by header print button
+await component.printReceipt();
+// All return receipts for process printed via print service
+```
+
+**Host Styling:**
+```scss
+:host {
+  @apply flex flex-col w-full justify-start mt-6 p-6 bg-white rounded-2xl;
+}
+```
+
+**Change Detection:** `OnPush` - Optimized change detection strategy
+
+---
+
+### ReturnReviewHeaderComponent
+
+Header component displaying success message and print button.
+
+**Selector:** `oms-feature-return-review-header`
+
+**Inputs:** None
+
+**Outputs:**
+
+##### `printReceipt: EventEmitter<void>`
+
+Emitted when user clicks the print receipt button.
+
+**Payload:** None (void event)
+
+**Template Structure:**
+```html
+<h2 class="isa-text-subtitle-1-regular">Die Rückgabe war erfolgreich!</h2>
+
+<button
+  data-what="button"
+  data-which="print-receipt"
+  class="self-start"
+  (click)="printReceipt.emit()"
+  uiInfoButton
+>
+  <span uiInfoButtonLabel>Rückgabe Bestätigung erneut drucken</span>
+  <ng-icon name="isaActionPrinter" uiInfoButtonIcon></ng-icon>
+</button>
+```
+
+**UI Components:**
+- `InfoButtonComponent` - Styled button with icon and label
+- `NgIconComponent` - Icon rendering with `isaActionPrinter` icon
+
+**Host Styling:**
+```scss
+:host {
+  @apply w-full
+         flex
+         flex-col
+         gap-6
+         desktop:gap-0
+         desktop:flex-row
+         desktop:justify-between
+         desktop:items-center
+         border-b
+         border-solid
+         border-isa-neutral-300
+         pb-6;
+}
+```
+
+**Responsive Behavior:**
+- **Mobile/Tablet**: Vertical stack (flex-col) with 24px gap
+- **Desktop**: Horizontal layout (flex-row) with space-between alignment
+
+**Change Detection:** `OnPush`
+
+**TODO Note:**
+```typescript
+// TODO: Kann direkt in der Komponente gehandled werden
+printReceipt = output<void>();
+```
+
+This comment suggests future refactoring to handle printing directly in the header component instead of emitting to parent. This would simplify the component hierarchy.
+
+---
+
+### UncompletedTasksGuard
+
+Navigation guard preventing users from leaving with uncompleted tasks.
+
+**Injection:** `{ providedIn: 'root' }` - Singleton guard
+
+**Implements:** `CanDeactivate<ReturnReviewComponent>`
+
+**Injected Services:**
+- `ReturnTaskListStore` - Task list state management
+- `injectConfirmationDialog()` - Confirmation dialog service
+- `injectTabId()` - Tab-based process ID
+
+**Computed Properties:**
+
+##### `uncompletedTaskListItems: Signal<ReceiptItemTaskListItem[]>`
+
+Computes list of uncompleted tasks for current process.
+
+**Logic:**
+1. Retrieves process ID from tab context
+2. Fetches task list entity from store by process ID
+3. Filters tasks where `completed === false`
+4. Returns empty array if no process ID or no tasks
+
+**Example:**
+```typescript
+// Process ID = 123, tasks: [{ id: 1, completed: false }, { id: 2, completed: true }]
+uncompletedTaskListItems() // Returns [{ id: 1, completed: false }]
+```
+
+**Methods:**
+
+##### `canDeactivate(): boolean | Promise<boolean>`
+
+Angular router guard method determining if navigation is allowed.
+
+**Return Values:**
+- `true` - Allow navigation (no uncompleted tasks)
+- `Promise<boolean>` - User confirmation required (has uncompleted tasks)
+
+**Logic:**
+```typescript
+const hasUncompletedTasks = this.uncompletedTaskListItems().length > 0;
+
+if (!hasUncompletedTasks) {
+  return true;  // No tasks pending - allow navigation
+}
+
+return this.openDialog();  // Confirm with user
+```
+
+##### `openDialog(): Promise<boolean>`
+
+Opens confirmation dialog for user to decide on navigation.
+
+**Dialog Configuration:**
+```typescript
+{
+  title: 'Aufgaben erledigen',
+  data: {
+    message: 'Bitte schließen Sie die Aufgaben ab bevor Sie das die Rückgabe verlassen',
+    closeText: 'Verlassen',
+    confirmText: 'Zurück',
+  },
+}
+```
+
+**Return Logic:**
+```typescript
+const result = await firstValueFrom(confirmDialogRef.closed);
+return !result?.confirmed;  // Invert: confirmed = stay, close = leave
+```
+
+**Dialog Result Mapping:**
+- User clicks "Zurück" (confirm): `confirmed === true` → returns `false` (block navigation)
+- User clicks "Verlassen" (close): `confirmed === false` → returns `true` (allow navigation)
+- User dismisses dialog: `confirmed === undefined` → returns `true` (allow navigation)
+
+## Usage Examples
+
+### Basic Return Review Flow
+
+```typescript
+import { Component } from '@angular/core';
+import { ReturnReviewComponent } from '@isa/oms/feature/return-review';
+
+@Component({
+  selector: 'app-returns-workflow',
+  standalone: true,
+  imports: [ReturnReviewComponent],
+  template: `
+    <oms-feature-return-review></oms-feature-return-review>
+  `
+})
+export class ReturnsWorkflowComponent {}
+```
+
+### Routing Configuration
+
+```typescript
+import { Routes } from '@angular/router';
+
+export const routes: Routes = [
+  {
+    path: 'returns',
+    children: [
+      {
+        path: 'search',
+        loadChildren: () =>
+          import('@isa/oms/feature/return-search').then((m) => m.routes),
+      },
+      {
+        path: 'details/:receiptId',
+        loadChildren: () =>
+          import('@isa/oms/feature/return-details').then((m) => m.routes),
+      },
+      {
+        path: 'process',
+        loadChildren: () =>
+          import('@isa/oms/feature/return-process').then((m) => m.routes),
+      },
+      {
+        path: 'review',
+        loadChildren: () =>
+          import('@isa/oms/feature/return-review').then((m) => m.routes),
+      },
+    ],
+  },
+];
+```
+
+### Programmatic Navigation to Review
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-return-process-complete',
+  template: '...',
+})
+export class ReturnProcessCompleteComponent {
+  #router = inject(Router);
+
+  finishReturn(): void {
+    // Navigate to review after completing return process
+    this.#router.navigate(['/returns/review']);
+  }
+}
+```
+
+### Custom Header with Print Button
+
+```typescript
+import { Component } from '@angular/core';
+import { ReturnReviewHeaderComponent } from '@isa/oms/feature/return-review';
+
+@Component({
+  selector: 'app-custom-review-header',
+  standalone: true,
+  imports: [ReturnReviewHeaderComponent],
+  template: `
+    <div class="custom-header-container">
+      <div class="branding">
+        <img src="/assets/logo.svg" alt="Company Logo" />
+      </div>
+
+      <oms-feature-return-review-header
+        (printReceipt)="handlePrint()"
+      ></oms-feature-return-review-header>
+
+      <div class="actions">
+        <button (click)="closeTab()">Fenster schließen</button>
+      </div>
+    </div>
+  `
+})
+export class CustomReviewHeaderComponent {
+  handlePrint(): void {
+    console.log('Printing receipts...');
+  }
+
+  closeTab(): void {
+    window.close();
+  }
+}
+```
+
+### Accessing Store for Custom Logic
+
+```typescript
+import { Component, inject, computed } from '@angular/core';
+import { ReturnProcessStore, ReturnTaskListStore } from '@isa/oms/data-access';
+import { injectTabId } from '@isa/core/tabs';
+import { ReturnReviewComponent } from '@isa/oms/feature/return-review';
+
+@Component({
+  selector: 'app-advanced-review',
+  standalone: true,
+  imports: [ReturnReviewComponent],
+  template: `
+    <div class="review-header">
+      <h1>Rückgabe erfolgreich</h1>
+      @if (hasPendingTasks()) {
+        <p class="warning">
+          Sie haben noch {{ pendingTaskCount() }} ausstehende Aufgaben
+        </p>
+      }
+    </div>
+
+    <oms-feature-return-review></oms-feature-return-review>
+  `
+})
+export class AdvancedReviewComponent {
+  #taskStore = inject(ReturnTaskListStore);
+  processId = injectTabId();
+
+  pendingTaskCount = computed(() => {
+    const processId = this.processId();
+    if (!processId) return 0;
+
+    const entity = this.#taskStore.entityMap()[processId];
+    return entity?.data?.filter(task => !task.completed).length ?? 0;
+  });
+
+  hasPendingTasks = computed(() => this.pendingTaskCount() > 0);
+}
+```
+
+### Handling Navigation Guard Events
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router, ActivatedRoute } from '@angular/router';
+import { Location } from '@angular/common';
+
+@Component({
+  selector: 'app-review-with-navigation',
+  template: `
+    <div>
+      <button (click)="navigateBack()">Zurück zur Suche</button>
+      <oms-feature-return-review></oms-feature-return-review>
+      <button (click)="startNewReturn()">Neue Rückgabe</button>
+    </div>
+  `
+})
+export class ReviewWithNavigationComponent {
+  #router = inject(Router);
+  #location = inject(Location);
+
+  navigateBack(): void {
+    // Will trigger UncompletedTasksGuard if tasks are pending
+    this.#location.back();
+  }
+
+  startNewReturn(): void {
+    // Will trigger UncompletedTasksGuard if tasks are pending
+    this.#router.navigate(['/returns/search']);
+  }
+}
+```
+
+### Testing Guard Behavior
+
+```typescript
+import { Component, inject, computed } from '@angular/core';
+import { Router } from '@angular/router';
+import { ReturnTaskListStore } from '@isa/oms/data-access';
+import { injectTabId } from '@isa/core/tabs';
+
+@Component({
+  selector: 'app-guard-test',
+  template: `
+    <div>
+      <p>Pending tasks: {{ pendingCount() }}</p>
+      <button (click)="tryNavigate()">Try Navigate</button>
+      <button (click)="completeTasks()">Complete All Tasks</button>
+    </div>
+  `
+})
+export class GuardTestComponent {
+  #router = inject(Router);
+  #store = inject(ReturnTaskListStore);
+  processId = injectTabId();
+
+  pendingCount = computed(() => {
+    const processId = this.processId();
+    if (!processId) return 0;
+
+    const entity = this.#store.entityMap()[processId];
+    return entity?.data?.filter(t => !t.completed).length ?? 0;
+  });
+
+  tryNavigate(): void {
+    // If pending tasks exist, guard will show confirmation dialog
+    this.#router.navigate(['/returns/search']);
+  }
+
+  completeTasks(): void {
+    // Complete all tasks to allow navigation without prompt
+    const processId = this.processId();
+    if (!processId) return;
+
+    const entity = this.#store.entityMap()[processId];
+    const tasks = entity?.data ?? [];
+
+    tasks.forEach(task => {
+      if (!task.completed) {
+        // Complete task via store update
+        this.#store.updateTaskListItem({
+          processId,
+          taskListItem: { ...task, completed: true }
+        });
+      }
+    });
+  }
+}
+```
+
+## Routing and Navigation
+
+### Route Configuration
+
+The library exports routes configured with the navigation guard:
+
+```typescript
+// libs/oms/feature/return-review/src/lib/routes.ts
+import { Routes } from '@angular/router';
+import { ReturnReviewComponent } from './return-review.component';
+import { UncompletedTasksGuard } from './guards/uncompleted-tasks.guard';
+
+export const routes: Routes = [
+  {
+    path: '',
+    component: ReturnReviewComponent,
+    canDeactivate: [UncompletedTasksGuard],
+  },
+];
+```
+
+**Key Features:**
+- **Empty path**: Component loads at parent route path
+- **Deactivation guard**: Prevents navigation with uncompleted tasks
+- **Standalone component**: No module wrapper required
+
+### Integration with OMS Workflow
+
+The return review fits into the OMS workflow as follows:
+
+```
+Return Search → Return Details → Return Process → Return Review
+   (search)        (select)         (process)        (confirm)
+```
+
+**Navigation Flow:**
+1. User searches for receipt (`/returns/search`)
+2. User selects items for return (`/returns/details/:receiptId`)
+3. User processes return items (`/returns/process`)
+4. System navigates to review (`/returns/review`)
+5. User reviews tasks and optionally reprints receipt
+6. User navigates away (with guard protection)
+
+### Programmatic Navigation
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-return-orchestrator',
+  template: '...'
+})
+export class ReturnOrchestratorComponent {
+  #router = inject(Router);
+
+  completeReturnProcess(): void {
+    // After completing return process steps
+    this.#router.navigate(['/returns/review']);
+  }
+
+  exitReview(): void {
+    // Navigate away from review
+    // Guard will check for uncompleted tasks
+    this.#router.navigate(['/returns/search']);
+  }
+
+  reopenProcess(): void {
+    // Navigate back to process from review
+    // Guard will check for uncompleted tasks
+    this.#router.navigate(['/returns/process']);
+  }
+}
+```
+
+### Guard Behavior in Routing
+
+The `UncompletedTasksGuard` integrates with Angular router lifecycle:
+
+**Scenario 1: No Uncompleted Tasks**
+```
+User clicks back button
+→ Guard checks uncompleted tasks
+→ None found
+→ Navigation proceeds immediately
+→ User sees previous route
+```
+
+**Scenario 2: Uncompleted Tasks Exist**
+```
+User clicks back button
+→ Guard checks uncompleted tasks
+→ Tasks found
+→ Confirmation dialog opens
+→ User clicks "Zurück" (confirm)
+→ Dialog closes
+→ Navigation blocked
+→ User remains on review page
+
+OR
+
+→ User clicks "Verlassen" (close)
+→ Dialog closes
+→ Navigation proceeds
+→ User sees previous route
+```
+
+### Route Resolver Pattern (Future Enhancement)
+
+Currently, the component relies on store state from previous routes. A future enhancement could use route resolvers:
+
+```typescript
+// Potential future enhancement
+export const routes: Routes = [
+  {
+    path: '',
+    component: ReturnReviewComponent,
+    canDeactivate: [UncompletedTasksGuard],
+    resolve: {
+      tasks: ReturnTasksResolver,  // Ensures tasks are loaded
+      receipts: ReturnReceiptsResolver  // Ensures receipts are available
+    }
+  },
+];
+```
+
+This would guarantee data availability even if users navigate directly to the route.
+
+## Architecture Notes
+
+### Current Architecture
+
+The library follows a component-based architecture with guard protection:
+
+```
+ReturnReviewComponent (orchestrator)
+       ↓
+├─→ ReturnReviewHeaderComponent (presentation)
+│   └─→ InfoButtonComponent (UI)
+│   └─→ NgIconComponent (UI)
+├─→ ReturnTaskListComponent (shared feature)
+│   └─→ [See @isa/oms/shared/task-list README]
+├─→ PrintReceiptsService (printing)
+├─→ ReturnProcessStore (state)
+└─→ Tab Context (process isolation)
+
+UncompletedTasksGuard (navigation protection)
+       ↓
+├─→ ReturnTaskListStore (task state)
+├─→ ConfirmationDialog (UI)
+└─→ Tab Context (process isolation)
+```
+
+### Design Patterns
+
+#### 1. Container/Presenter Pattern
+
+**Container:** `ReturnReviewComponent`
+- Manages process ID via tab context
+- Handles receipt printing logic
+- Orchestrates child components
+- Interacts with stores and services
+
+**Presenter:** `ReturnReviewHeaderComponent`
+- Pure presentation logic
+- Emits events to parent
+- No direct service dependencies (except icon provider)
+- Receives all data via inputs (currently none)
+
+**Benefits:**
+- Clear separation of concerns
+- Header component is highly reusable
+- Easy to test in isolation
+- Simple data flow
+
+#### 2. Tab-Based Process Isolation
+
+```typescript
+// Each browser tab gets unique process context
+processId = injectTabId();  // Signal<number | undefined>
+
+// Guard also uses tab context
+processId = injectTabId();  // Same signal, same value
+
+// Store lookups use process ID
+const entity = store.entityMap()[processId()];
+```
+
+**Benefits:**
+- Multiple simultaneous return reviews in different tabs
+- No cross-tab state interference
+- Automatic cleanup when tab closes
+- No manual process ID management
+
+#### 3. Declarative Routing with Guards
+
+```typescript
+export const routes: Routes = [
+  {
+    path: '',
+    component: ReturnReviewComponent,
+    canDeactivate: [UncompletedTasksGuard],  // Declarative protection
+  },
+];
+```
+
+**Benefits:**
+- Guard logic separate from component
+- Reusable across routes
+- Clear intent in route configuration
+- Angular handles lifecycle automatically
+
+#### 4. Delegation to Shared Components
+
+```html
+<oms-shared-return-task-list
+  [appearance]="'review'"
+></oms-shared-return-task-list>
+```
+
+**Benefits:**
+- No duplication of task list logic
+- Consistent task display across features
+- Shared component handles complexity
+- Review component stays focused
+
+#### 5. Store-Based State Management
+
+```typescript
+// Component reads from store
+const receiptIds = this.#returnProcessStore
+  .entities()
+  .filter((p) => p.processId === processId && p.returnReceipt?.id)
+  .map((p) => p.returnReceipt!.id);
+```
+
+**Benefits:**
+- Single source of truth
+- Reactive updates
+- Store managed elsewhere (return process feature)
+- Component consumes, doesn't manage
+
+### Known Architectural Considerations
+
+#### 1. Header Component Output Pattern (Low Priority)
+
+**Current State:**
+```typescript
+// ReturnReviewHeaderComponent
+printReceipt = output<void>();
+
+// ReturnReviewComponent
+<oms-feature-return-review-header
+  (printReceipt)="printReceipt()"
+></oms-feature-return-review-header>
+```
+
+**TODO Comment:**
+```typescript
+// TODO: Kann direkt in der Komponente gehandled werden
+```
+
+**Issue:**
+- Header emits event to parent
+- Parent handles printing logic
+- Unnecessary indirection for single-purpose button
+
+**Proposed Refactoring:**
+```typescript
+// ReturnReviewHeaderComponent (future)
+export class ReturnReviewHeaderComponent {
+  #printReceiptsService = inject(PrintReceiptsService);
+  #returnProcessStore = inject(ReturnProcessStore);
+  processId = injectTabId();
+
+  async printReceipt(): void {
+    // Handle printing directly in header
+    const processId = this.processId();
+    if (processId) {
+      const receiptIds = this.#returnProcessStore
+        .entities()
+        .filter((p) => p.processId === processId && p.returnReceipt?.id)
+        .map((p) => p.returnReceipt!.id);
+
+      await this.#printReceiptsService.printReturnReceipts({
+        returnReceiptIds: receiptIds,
+      });
+    }
+  }
+}
+
+// ReturnReviewComponent (future)
+<oms-feature-return-review-header></oms-feature-return-review-header>
+// No output binding needed
+```
+
+**Benefits:**
+- Simpler component tree
+- No unnecessary event propagation
+- Header is self-contained
+- Parent component simplified
+
+**Impact:** Low - current pattern works, refactoring is optimization
+
+#### 2. Guard State Duplication (Medium Priority)
+
+**Current State:**
+```typescript
+// UncompletedTasksGuard
+#returnTaskListStore = inject(ReturnTaskListStore);
+processId = injectTabId();
+
+uncompletedTaskListItems = computed(() => {
+  const processId = this.processId();
+  // ... filter logic
+});
+
+// Similar logic could exist in components
+```
+
+**Issue:**
+- Guard recomputes uncompleted tasks
+- Component might have similar logic
+- Potential duplication of filtering logic
+- Guard is stateful (uses computed signals)
+
+**Proposed Enhancement:**
+```typescript
+// Create shared service
+export class ReturnTaskValidator {
+  #store = inject(ReturnTaskListStore);
+
+  hasUncompletedTasks(processId: number): boolean {
+    const entity = this.#store.entityMap()[processId];
+    return entity?.data?.some(task => !task.completed) ?? false;
+  }
+
+  getUncompletedTasks(processId: number): ReceiptItemTaskListItem[] {
+    const entity = this.#store.entityMap()[processId];
+    return entity?.data?.filter(task => !task.completed) ?? [];
+  }
+}
+
+// Guard uses service
+export class UncompletedTasksGuard implements CanDeactivate<ReturnReviewComponent> {
+  #validator = inject(ReturnTaskValidator);
+  processId = injectTabId();
+
+  canDeactivate(): boolean | Promise<boolean> {
+    const processId = this.processId();
+    if (!processId || !this.#validator.hasUncompletedTasks(processId)) {
+      return true;
+    }
+    return this.openDialog();
+  }
+}
+```
+
+**Benefits:**
+- Centralized task validation logic
+- Guard becomes stateless function
+- Reusable across components and guards
+- Easier to test
+
+**Impact:** Medium - improves maintainability and testability
+
+#### 3. Print Failure User Feedback (Medium Priority)
+
+**Current State:**
+```typescript
+async printReceipt() {
+  // ...
+  await this.#printReceiptsService.printReturnReceipts({
+    returnReceiptIds: receiptIds,
+  });
+  // No error handling, no user feedback
+}
+```
+
+**Issue:**
+- Print service may fail silently
+- User doesn't know if printing succeeded
+- No retry mechanism
+- No loading indicator
+
+**Proposed Enhancement:**
+```typescript
+async printReceipt() {
+  const processId = this.processId();
+  if (!processId) return;
+
+  const receiptIds = this.#returnProcessStore
+    .entities()
+    .filter((p) => p.processId === processId && p.returnReceipt?.id)
+    .map((p) => p.returnReceipt!.id);
+
+  try {
+    // Show loading state
+    this.isPrinting.set(true);
+
+    await this.#printReceiptsService.printReturnReceipts({
+      returnReceiptIds: receiptIds,
+    });
+
+    // Show success toast
+    this.#toastService.success('Belege erfolgreich gedruckt');
+  } catch (error) {
+    // Show error toast with retry option
+    this.#toastService.error('Drucken fehlgeschlagen', {
+      action: {
+        label: 'Erneut versuchen',
+        handler: () => this.printReceipt()
+      }
+    });
+  } finally {
+    this.isPrinting.set(false);
+  }
+}
+```
+
+**Benefits:**
+- Clear user feedback
+- Error recovery mechanism
+- Loading state prevents double-clicks
+- Better UX
+
+**Impact:** Medium - improves user experience and error handling
+
+#### 4. Direct Store Entity Access (Low Priority)
+
+**Current State:**
+```typescript
+const receiptIds = this.#returnProcessStore
+  .entities()
+  .filter((p) => p.processId === processId && p.returnReceipt?.id)
+  .map((p) => p.returnReceipt!.id);
+```
+
+**Observation:**
+- Component directly accesses store entities
+- Filter logic embedded in component
+- Non-null assertion (`!`) indicates assumed structure
+- No type guard for returnReceipt existence
+
+**Proposed Enhancement:**
+```typescript
+// Add selector to store or create service
+export class ReturnProcessStore extends SignalStore {
+  // ... existing store code
+
+  getReceiptIdsForProcess(processId: number): number[] {
+    return this.entities()
+      .filter((p) =>
+        p.processId === processId &&
+        p.returnReceipt?.id !== undefined
+      )
+      .map((p) => p.returnReceipt.id);
+  }
+}
+
+// Component uses selector
+const receiptIds = this.#returnProcessStore.getReceiptIdsForProcess(processId);
+```
+
+**Benefits:**
+- Encapsulates query logic in store
+- Type-safe, no non-null assertions
+- Reusable across components
+- Easier to test and maintain
+
+**Impact:** Low - current pattern works, enhancement improves encapsulation
+
+### Performance Considerations
+
+#### 1. Tab-Based Process Isolation
+- O(1) store lookup via process ID
+- No iteration over all processes
+- Isolated state prevents memory leaks
+- Efficient cleanup when tab closes
+
+#### 2. Delegated Task Rendering
+- Task list component handles virtualization
+- Review component has minimal rendering logic
+- Deferred rendering in task list reduces initial load
+- OnPush change detection minimizes checks
+
+#### 3. Guard Computation
+```typescript
+uncompletedTaskListItems = computed(() => {
+  // Only recomputes when dependencies change
+  // processId signal or store entity signal
+});
+```
+- Computed signals cache results
+- Only recalculates when process ID or tasks change
+- Efficient for navigation checks
+
+#### 4. Store Entity Access
+```typescript
+this.#returnProcessStore.entities()
+```
+- Direct array access (no observable subscription)
+- Filters executed on-demand
+- No memory held by subscriptions
+- Component cleanup is simple
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Loading States** - Add loading indicator during receipt printing
+2. **Success Feedback** - Toast notification on successful print
+3. **Error Handling** - User-visible error messages with retry option
+4. **Print Preview** - Show preview before printing all receipts
+5. **Selective Printing** - Allow printing individual receipts
+6. **Task Summary** - Show completion statistics (e.g., "3 of 5 tasks completed")
+7. **Export Functionality** - Export task list to PDF or CSV
+8. **Time Tracking** - Display time taken for return process
+9. **Header Refactoring** - Move print logic into header component
+10. **Shared Validator** - Extract task validation to shared service
+11. **Route Resolver** - Add resolver to ensure data availability
+12. **Accessibility** - ARIA labels and keyboard navigation for guard dialog
+
+## Dependencies
+
+### Required Libraries
+
+#### Angular Core
+- `@angular/core` - Angular framework, signals, dependency injection
+- `@angular/common` - Common Angular utilities (Location service)
+
+#### OMS Domain
+
+**Feature Libraries:**
+- `@isa/oms/shared/task-list` - Task list component in review mode
+  - `ReturnTaskListComponent` - Main task display component
+
+**Data Access:**
+- `@isa/oms/data-access` - Data services and stores
+  - `PrintReceiptsService` - Receipt printing operations
+  - `ReturnProcessStore` - Return process state management
+  - `ReturnTaskListStore` - Task list state management
+  - `ReceiptItemTaskListItem` - Task data model
+
+#### UI Components
+- `@isa/ui/buttons` - Button components
+  - `InfoButtonComponent` - Info button with icon and label
+- `@isa/ui/dialog` - Dialog components
+  - `injectConfirmationDialog()` - Confirmation dialog service
+
+#### Core Services
+- `@isa/core/tabs` - Tab context management
+  - `injectTabId()` - Process ID from tab context
+
+#### Icons
+- `@isa/icons` - ISA icon set
+  - `isaActionPrinter` - Printer icon
+- `@ng-icons/core` - Icon component infrastructure
+  - `NgIconComponent` - Icon rendering component
+  - `provideIcons()` - Icon provider function
+
+#### State Management
+- `@ngrx/signals` - Signal-based state management (indirect via stores)
+
+#### Utilities
+- `rxjs` - Reactive programming
+  - `firstValueFrom` - Promise conversion for observables
+
+### Development Dependencies
+
+- `jest` - Testing framework
+- `@nx/jest` - Nx Jest integration
+- `jest-preset-angular` - Angular-specific Jest configuration
+- `@angular/compiler-cli` - Angular compiler
+- `typescript` - TypeScript compiler
+
+### Path Alias
+
+Import from: `@isa/oms/feature/return-review`
+
+**Example:**
+```typescript
+import { routes } from '@isa/oms/feature/return-review';
+```
+
+## Testing
+
+The library uses **Jest** with **Angular Testing Utilities** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test return-review --skip-nx-cache
+
+# Run tests with coverage
+npx nx test return-review --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test return-review --watch
+
+# Run specific test file
+npx nx test return-review --testFile=src/lib/return-review.component.spec.ts --skip-nx-cache
+```
+
+### Test Structure (Recommended)
+
+#### Testing ReturnReviewComponent
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach, jest } from '@jest/globals';
+import { ReturnReviewComponent } from './return-review.component';
+import { PrintReceiptsService, ReturnProcessStore } from '@isa/oms/data-access';
+import { provideLocationMocks } from '@angular/common/testing';
+import { signal } from '@angular/core';
+
+describe('ReturnReviewComponent', () => {
+  let component: ReturnReviewComponent;
+  let fixture: ComponentFixture<ReturnReviewComponent>;
+  let mockPrintService: jest.Mocked<PrintReceiptsService>;
+  let mockStore: jest.Mocked<ReturnProcessStore>;
+
+  beforeEach(async () => {
+    mockPrintService = {
+      printReturnReceipts: jest.fn(() => Promise.resolve())
+    } as any;
+
+    mockStore = {
+      entities: jest.fn(() => [])
+    } as any;
+
+    await TestBed.configureTestingModule({
+      imports: [ReturnReviewComponent],
+      providers: [
+        { provide: PrintReceiptsService, useValue: mockPrintService },
+        { provide: ReturnProcessStore, useValue: mockStore },
+        provideLocationMocks(),
+      ]
+    }).compileComponents();
+
+    fixture = TestBed.createComponent(ReturnReviewComponent);
+    component = fixture.componentInstance;
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+
+  it('should print receipts when printReceipt is called', async () => {
+    // Arrange
+    const mockProcessId = 123;
+    component['processId'] = signal(mockProcessId);
+
+    const mockProcesses = [
+      { processId: 123, returnReceipt: { id: 1 } },
+      { processId: 123, returnReceipt: { id: 2 } },
+      { processId: 456, returnReceipt: { id: 3 } }, // Different process
+    ];
+    mockStore.entities.mockReturnValue(mockProcesses as any);
+
+    // Act
+    await component.printReceipt();
+
+    // Assert
+    expect(mockPrintService.printReturnReceipts).toHaveBeenCalledWith({
+      returnReceiptIds: [1, 2]
+    });
+  });
+
+  it('should filter out processes without return receipt ID', async () => {
+    // Arrange
+    const mockProcessId = 123;
+    component['processId'] = signal(mockProcessId);
+
+    const mockProcesses = [
+      { processId: 123, returnReceipt: { id: 1 } },
+      { processId: 123, returnReceipt: null }, // No receipt
+      { processId: 123 }, // No returnReceipt property
+    ];
+    mockStore.entities.mockReturnValue(mockProcesses as any);
+
+    // Act
+    await component.printReceipt();
+
+    // Assert
+    expect(mockPrintService.printReturnReceipts).toHaveBeenCalledWith({
+      returnReceiptIds: [1]
+    });
+  });
+
+  it('should not print if process ID is undefined', async () => {
+    // Arrange
+    component['processId'] = signal(undefined);
+
+    // Act
+    await component.printReceipt();
+
+    // Assert
+    expect(mockPrintService.printReturnReceipts).not.toHaveBeenCalled();
+  });
+});
+```
+
+#### Testing ReturnReviewHeaderComponent
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach } from '@jest/globals';
+import { ReturnReviewHeaderComponent } from './return-review-header.component';
+
+describe('ReturnReviewHeaderComponent', () => {
+  let component: ReturnReviewHeaderComponent;
+  let fixture: ComponentFixture<ReturnReviewHeaderComponent>;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      imports: [ReturnReviewHeaderComponent]
+    }).compileComponents();
+
+    fixture = TestBed.createComponent(ReturnReviewHeaderComponent);
+    component = fixture.componentInstance;
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+
+  it('should display success message', () => {
+    // Arrange & Act
+    fixture.detectChanges();
+
+    // Assert
+    const heading = fixture.nativeElement.querySelector('h2');
+    expect(heading?.textContent).toContain('Die Rückgabe war erfolgreich!');
+  });
+
+  it('should emit printReceipt event when button clicked', () => {
+    // Arrange
+    let emitted = false;
+    component.printReceipt.subscribe(() => {
+      emitted = true;
+    });
+
+    fixture.detectChanges();
+
+    // Act
+    const button = fixture.nativeElement.querySelector(
+      '[data-what="button"][data-which="print-receipt"]'
+    );
+    button?.click();
+
+    // Assert
+    expect(emitted).toBe(true);
+  });
+
+  it('should have correct E2E testing attributes', () => {
+    // Arrange & Act
+    fixture.detectChanges();
+
+    // Assert
+    const button = fixture.nativeElement.querySelector(
+      '[data-what="button"][data-which="print-receipt"]'
+    );
+    expect(button).toBeTruthy();
+    expect(button.getAttribute('data-what')).toBe('button');
+    expect(button.getAttribute('data-which')).toBe('print-receipt');
+  });
+
+  it('should display printer icon', () => {
+    // Arrange & Act
+    fixture.detectChanges();
+
+    // Assert
+    const icon = fixture.nativeElement.querySelector('ng-icon');
+    expect(icon).toBeTruthy();
+    expect(icon.getAttribute('name')).toBe('isaActionPrinter');
+  });
+});
+```
+
+#### Testing UncompletedTasksGuard
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach, jest } from '@jest/globals';
+import { UncompletedTasksGuard } from './uncompleted-tasks.guard';
+import { ReturnTaskListStore } from '@isa/oms/data-access';
+import { signal } from '@angular/core';
+import { of } from 'rxjs';
+
+describe('UncompletedTasksGuard', () => {
+  let guard: UncompletedTasksGuard;
+  let mockStore: jest.Mocked<ReturnTaskListStore>;
+  let mockDialog: jest.Mock;
+
+  beforeEach(() => {
+    mockStore = {
+      entityMap: jest.fn(() => ({}))
+    } as any;
+
+    mockDialog = jest.fn();
+
+    TestBed.configureTestingModule({
+      providers: [
+        UncompletedTasksGuard,
+        { provide: ReturnTaskListStore, useValue: mockStore },
+      ]
+    });
+
+    guard = TestBed.inject(UncompletedTasksGuard);
+    guard['processId'] = signal(123);
+    guard['#confirmationDialog'] = mockDialog as any;
+  });
+
+  it('should create', () => {
+    expect(guard).toBeTruthy();
+  });
+
+  it('should allow navigation when no uncompleted tasks', () => {
+    // Arrange
+    const mockTasks = [
+      { id: 1, completed: true },
+      { id: 2, completed: true }
+    ];
+    mockStore.entityMap.mockReturnValue({
+      123: { id: 123, data: mockTasks, status: 'Success' }
+    } as any);
+
+    // Act
+    const result = guard.canDeactivate();
+
+    // Assert
+    expect(result).toBe(true);
+    expect(mockDialog).not.toHaveBeenCalled();
+  });
+
+  it('should block navigation and show dialog when uncompleted tasks exist', async () => {
+    // Arrange
+    const mockTasks = [
+      { id: 1, completed: true },
+      { id: 2, completed: false }  // Uncompleted task
+    ];
+    mockStore.entityMap.mockReturnValue({
+      123: { id: 123, data: mockTasks, status: 'Success' }
+    } as any);
+
+    mockDialog.mockReturnValue({
+      closed: of({ confirmed: true })  // User clicks "Zurück"
+    });
+
+    // Act
+    const result = await guard.canDeactivate();
+
+    // Assert
+    expect(mockDialog).toHaveBeenCalled();
+    expect(result).toBe(false);  // Block navigation
+  });
+
+  it('should allow navigation if user confirms leaving', async () => {
+    // Arrange
+    const mockTasks = [
+      { id: 1, completed: false }
+    ];
+    mockStore.entityMap.mockReturnValue({
+      123: { id: 123, data: mockTasks, status: 'Success' }
+    } as any);
+
+    mockDialog.mockReturnValue({
+      closed: of({ confirmed: false })  // User clicks "Verlassen"
+    });
+
+    // Act
+    const result = await guard.canDeactivate();
+
+    // Assert
+    expect(result).toBe(true);  // Allow navigation
+  });
+
+  it('should handle missing process ID', () => {
+    // Arrange
+    guard['processId'] = signal(undefined);
+
+    // Act
+    const result = guard.canDeactivate();
+
+    // Assert
+    expect(result).toBe(true);
+  });
+
+  it('should handle missing task data', () => {
+    // Arrange
+    mockStore.entityMap.mockReturnValue({
+      123: { id: 123, data: undefined, status: 'Pending' }
+    } as any);
+
+    // Act
+    const result = guard.canDeactivate();
+
+    // Assert
+    expect(result).toBe(true);
+  });
+});
+```
+
+### Test Coverage Goals
+
+- **Component Logic**: 80%+ coverage
+- **Guard Logic**: 90%+ coverage (critical for data integrity)
+- **Template Rendering**: Test all conditional paths
+- **User Interactions**: Test all button clicks and events
+- **Store Integration**: Mock store methods and verify calls
+- **E2E Attributes**: Verify all data-what/data-which attributes exist
+
+### E2E Testing
+
+The component includes E2E testing attributes for automated testing:
+
+```typescript
+// Example Playwright test
+import { test, expect } from '@playwright/test';
+
+test.describe('Return Review', () => {
+  test('should display success message', async ({ page }) => {
+    // Navigate to review page
+    await page.goto('/returns/review');
+
+    // Verify success message
+    await expect(page.locator('h2')).toContainText('Die Rückgabe war erfolgreich!');
+  });
+
+  test('should print receipt on button click', async ({ page }) => {
+    await page.goto('/returns/review');
+
+    // Monitor for print dialog or download
+    const [download] = await Promise.all([
+      page.waitForEvent('download'),
+      page.click('[data-what="button"][data-which="print-receipt"]')
+    ]);
+
+    expect(download).toBeTruthy();
+  });
+
+  test('should show task list in review mode', async ({ page }) => {
+    await page.goto('/returns/review');
+
+    // Verify task list component is present
+    await expect(
+      page.locator('oms-shared-return-task-list')
+    ).toBeVisible();
+  });
+
+  test('should prompt when navigating with uncompleted tasks', async ({ page }) => {
+    await page.goto('/returns/review');
+
+    // Assume tasks exist and are not completed
+    page.on('dialog', async (dialog) => {
+      expect(dialog.message()).toContain('Aufgaben erledigen');
+      await dialog.dismiss(); // Click "Verlassen"
+    });
+
+    // Try to navigate away
+    await page.click('[data-which="back-button"]');
+
+    // Should show dialog (handled by event listener)
+  });
+});
+```
+
+## Best Practices
+
+### 1. Rely on Tab Context for Process ID
+
+```typescript
+// ✅ GOOD: Component automatically uses tab-based process ID
+// No manual process ID management needed
+<oms-feature-return-review></oms-feature-return-review>
+
+// ❌ BAD: Trying to manually pass process ID
+// Component handles this internally via injectTabId()
+<oms-feature-return-review [processId]="123"></oms-feature-return-review>
+```
+
+### 2. Trust the Navigation Guard
+
+```typescript
+// ✅ GOOD: Guard automatically checks for uncompleted tasks
+// No additional confirmation logic needed in components
+
+// ❌ BAD: Duplicate confirmation logic
+async navigateAway() {
+  const hasTasks = this.checkUncompletedTasks(); // Guard already does this
+  if (hasTasks) {
+    const confirm = await this.showDialog();
+    if (!confirm) return;
+  }
+  this.router.navigate(['/search']);
+}
+```
+
+### 3. Let Task List Handle Display
+
+```typescript
+// ✅ GOOD: Use shared task list component
+<oms-shared-return-task-list
+  [appearance]="'review'"
+></oms-shared-return-task-list>
+
+// ❌ BAD: Duplicate task list implementation
+<div *ngFor="let task of tasks()">
+  <!-- Custom task rendering duplicates shared component -->
+</div>
+```
+
+### 4. Use E2E Attributes Consistently
+
+```typescript
+// ✅ GOOD: Include data attributes for testing
+<button
+  (click)="handleAction()"
+  data-what="button"
+  data-which="custom-action"
+>
+  Custom Action
+</button>
+
+// ❌ BAD: No testing attributes
+<button (click)="handleAction()">
+  Custom Action
+</button>
+```
+
+### 5. Handle Print Failures Gracefully
+
+```typescript
+// ✅ GOOD: Wrap print calls in try-catch
+try {
+  await this.printReceipt();
+  // Consider adding success feedback
+} catch (error) {
+  console.error('Print failed', error);
+  // Consider showing error message to user
+}
+
+// ❌ BAD: Assume printing always succeeds
+await this.printReceipt(); // No error handling
+```
+
+### 6. Respect Component Hierarchy
+
+```typescript
+// ✅ GOOD: Use component as designed
+<oms-feature-return-review-header
+  (printReceipt)="handlePrint()"
+></oms-feature-return-review-header>
+
+// ❌ BAD: Bypass component and access services directly
+// Breaks encapsulation
+const header = this.headerComponent;
+header.#printReceiptsService.printReturnReceipts(...);
+```
+
+### 7. Navigate After Process Completion
+
+```typescript
+// ✅ GOOD: Navigate to review as final step
+async completeReturn() {
+  await this.returnService.complete();
+  this.router.navigate(['/returns/review']);
+}
+
+// ❌ BAD: Navigate before process completes
+this.router.navigate(['/returns/review']); // May show incomplete state
+await this.returnService.complete();
+```
+
+### 8. Style with CSS Classes, Not Inline Styles
+
+```scss
+// ✅ GOOD: Override via CSS classes
+oms-feature-return-review-header {
+  padding: 2rem;
+  background-color: var(--custom-bg);
+}
+
+// ❌ BAD: Inline styles in template
+<oms-feature-return-review-header
+  style="padding: 2rem;"
+></oms-feature-return-review-header>
+```
+
+### 9. Handle Missing Process ID
+
+```typescript
+// ✅ GOOD: Check for process ID before operations
+async printReceipt() {
+  const processId = this.processId();
+  if (!processId) {
+    console.warn('No process ID available');
+    return;
+  }
+  // Continue with printing
+}
+
+// ❌ BAD: Assume process ID always exists
+async printReceipt() {
+  const processId = this.processId()!; // Non-null assertion
+  // Will fail if processId is undefined
+}
+```
+
+### 10. Test Guard Behavior
+
+```typescript
+// ✅ GOOD: Test all guard scenarios
+it('should allow navigation without tasks', () => {
+  expect(guard.canDeactivate()).toBe(true);
+});
+
+it('should block navigation with tasks', async () => {
+  // Setup uncompleted tasks
+  const result = await guard.canDeactivate();
+  expect(result).toBe(false);
+});
+
+// ❌ BAD: Only test happy path
+it('should work', () => {
+  expect(guard.canDeactivate()).toBe(true);
+});
+```
+
+### 11. Consider Accessibility
+
+```typescript
+// ✅ GOOD: Add ARIA labels and roles
+<div role="status" aria-live="polite">
+  <h2>Die Rückgabe war erfolgreich!</h2>
+</div>
+
+<button
+  aria-label="Rückgabe Bestätigung erneut drucken"
+  (click)="printReceipt()"
+>
+  <ng-icon name="isaActionPrinter"></ng-icon>
+</button>
+
+// ⚠️ CURRENT STATE: Limited accessibility
+// Consider enhancement for screen reader support
+```
+
+### 12. Monitor Store State for Advanced Features
+
+```typescript
+// ✅ GOOD: Use computed signals for derived data
+import { computed } from '@angular/core';
+
+receiptCount = computed(() => {
+  const processId = this.processId();
+  if (!processId) return 0;
+
+  return this.#returnProcessStore
+    .entities()
+    .filter(p => p.processId === processId && p.returnReceipt?.id)
+    .length;
+});
+
+// ❌ BAD: Direct store manipulation
+this.#returnProcessStore.entities()[0] = newData; // Breaks store contract
+```
+
+---
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/oms/feature/return-search/README.md b/libs/oms/feature/return-search/README.md
index ba7650332..b8e45117b 100644
--- a/libs/oms/feature/return-search/README.md
+++ b/libs/oms/feature/return-search/README.md
@@ -1,7 +1,1439 @@
-# oms-feature-return-search
+# @isa/oms/feature/return-search
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive return search feature library for Angular applications, providing intelligent receipt search, filtering, and navigation capabilities for the Order Management System (OMS).
 
-## Running unit tests
+## Overview
 
-Run `nx test oms-feature-return-search` to execute the unit tests.
+The Return Search Feature library provides a complete user interface for searching and browsing receipt records in the return process workflow. It offers advanced filtering, sorting, and pagination capabilities with intelligent navigation patterns, automatic single-result handling, and responsive design. The library integrates with the OMS data access layer and shared filter system to deliver a seamless search experience.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [Component Reference](#component-reference)
+- [Routing Configuration](#routing-configuration)
+- [Usage Examples](#usage-examples)
+- [State Management](#state-management)
+- [Filter Integration](#filter-integration)
+- [Responsive Design](#responsive-design)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+- [Dependencies](#dependencies)
+
+## Features
+
+- **Multi-criteria search** - Search by receipt number, email, customer name, or QR code
+- **Advanced filtering** - Dynamic filter menu with configurable filter inputs
+- **Flexible sorting** - Order-by toolbar with customizable sort options
+- **Infinite scrolling** - Automatic pagination with viewport-based loading
+- **Intelligent navigation** - Auto-redirect to receipt details when only one result found
+- **Responsive design** - Adaptive layouts for mobile, tablet, and desktop screens
+- **State persistence** - Filter state synchronized with query parameters
+- **Scroll restoration** - Automatic scroll position restoration when navigating back
+- **Task list integration** - Display ongoing return tasks alongside search interface
+- **Empty state handling** - User-friendly messages for no results scenarios
+- **Loading indicators** - Progressive loading states for search, pagination, and items
+- **QR code scanning** - Support for scanning receipt QR codes from emails
+
+## Quick Start
+
+### 1. Import Routes
+
+```typescript
+import { Routes } from '@angular/router';
+
+const routes: Routes = [
+  {
+    path: 'returns',
+    loadChildren: () =>
+      import('@isa/oms/feature/return-search').then((m) => m.routes),
+  },
+];
+```
+
+### 2. Navigate to Search
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-returns-dashboard',
+  template: `
+    <button (click)="startReturnSearch()">Start Return Search</button>
+  `
+})
+export class ReturnsDashboardComponent {
+  #router = inject(Router);
+
+  startReturnSearch() {
+    this.#router.navigate(['/returns']);
+  }
+}
+```
+
+### 3. Basic Search Flow
+
+The search flow is automatically handled by the library:
+
+1. User enters search term (receipt number, email, or customer name)
+2. User clicks search or presses Enter
+3. If exactly 1 result: Navigate directly to receipt details
+4. If multiple results: Display results list with filters and sorting
+5. User clicks result: Navigate to receipt details
+
+## Core Concepts
+
+### Search Process
+
+The return search follows a multi-step process managed by the `ReturnSearchStore`:
+
+1. **Query Building** - Filter inputs are collected and combined into a search query
+2. **Query Execution** - The query is sent to the backend via `ReturnSearchService`
+3. **Result Handling** - Results are stored in the NgRx Signals store per process ID
+4. **Navigation Decision** - Single results trigger automatic navigation
+5. **Pagination** - Additional results loaded via infinite scroll
+
+### Process ID and Tabs
+
+The library uses a **tab-based architecture** where each search session is identified by a unique `processId`:
+
+```typescript
+// Each browser tab gets a unique process ID
+private _processId = injectTabId();
+
+// Search results are stored per process ID
+this._returnSearchStore.search({
+  processId,
+  query: this._filterService.query(),
+  clear: true
+});
+
+// Entity retrieval uses the process ID
+const entity = this._returnSearchStore.getEntity(processId);
+```
+
+This allows multiple concurrent search sessions across different browser tabs without data conflicts.
+
+### Filter System Integration
+
+The library integrates with `@isa/shared/filter` for advanced filtering:
+
+- **Query Settings Resolver** - Loads filter configuration from backend
+- **Query Params Sync** - Synchronizes filter state with URL query parameters
+- **Filter Groups** - Separates search input from filter inputs
+- **Commit Pattern** - Changes are committed before search execution
+
+### Search Status States
+
+Search operations progress through defined states:
+
+```typescript
+enum ReturnSearchStatus {
+  Idle = 'idle',           // No search performed yet
+  Pending = 'pending',     // Search in progress
+  Success = 'success',     // Search completed successfully
+  Error = 'error'          // Search failed
+}
+```
+
+## Component Reference
+
+### ReturnSearchComponent
+
+Root component providing filter context and routing outlet.
+
+**Selector:** `oms-feature-return-search`
+
+**Template:** Simple router outlet for child routes
+
+**Providers:**
+- `provideFilter()` - Filter service with query settings factory and params sync
+
+**Host Classes:**
+```css
+flex flex-col gap-5 isa-desktop:gap-6 items-center overflow-x-hidden
+```
+
+**Usage:**
+```typescript
+// Automatically used when routes are loaded
+// No direct usage required
+```
+
+---
+
+### ReturnSearchMainComponent
+
+Main search interface with search bar, filters, and task list.
+
+**Selector:** `oms-feature-return-search-main`
+
+**Inputs:** None (uses injected services)
+
+**Outputs:** None (navigation-based)
+
+**Key Features:**
+- Search bar with QR code scanning support
+- Dynamic filter input buttons
+- Pending state indicator
+- Task list integration
+- Automatic navigation based on result count
+
+**Template Structure:**
+```html
+<div class="search-header">
+  <h1>Rückgabe starten</h1>
+  <filter-search-bar-input (triggerSearch)="onSearch()">
+  <filter-input-menu-button *ngFor="let filter of filterInputs()">
+</div>
+<oms-shared-return-task-list>
+```
+
+**Computed Signals:**
+
+| Signal | Type | Description |
+|--------|------|-------------|
+| `entityPending` | `boolean` | True when search is in pending state |
+| `filterInputs` | `FilterInput[]` | Filtered list of filter inputs (group='filter') |
+
+**Methods:**
+
+#### `onSearch(): void`
+
+Initiates a new search with current filter values.
+
+**Behavior:**
+- Commits current filter state
+- Clears previous results
+- Executes search with callback
+- Automatically navigates based on result count
+
+**Example:**
+```typescript
+// Triggered by search bar or filter changes
+onSearch() {
+  const processId = this._processId();
+  if (processId) {
+    this._filterService.commit();
+    this._returnSearchStore.search({
+      processId,
+      query: this._filterService.query(),
+      clear: true,
+      cb: this.onSearchCb
+    });
+  }
+}
+```
+
+#### `onSearchCb(result: CallbackResult<ListResponseArgs<ReceiptListItem>>): void`
+
+Callback for search results, handles automatic navigation.
+
+**Navigation Rules:**
+- **1 result**: Navigate to `receipt/:id`
+- **Multiple results**: Navigate to `receipts` list
+- **0 results**: Stay on search page (handled by result component)
+
+---
+
+### ReturnSearchResultComponent
+
+Results list with filtering, sorting, and infinite scroll pagination.
+
+**Selector:** `oms-feature-return-search-result`
+
+**Inputs:** None (uses route data and injected services)
+
+**Outputs:** None (navigation-based)
+
+**Key Features:**
+- Responsive filter and sort controls
+- Infinite scroll pagination with viewport detection
+- Scroll position restoration
+- Empty state handling
+- Progressive loading indicators
+- Mobile-optimized layout
+
+**Template Structure:**
+```html
+<filter-search-bar-input (triggerSearch)="search()">
+<filter-filter-menu-button>
+<filter-order-by-toolbar>
+
+<span>{{ entityHits() }} Einträge</span>
+
+@for (item of entityItems(); track item.id) {
+  <a [routerLink]="['../', 'receipt', item.id]">
+    <oms-feature-return-search-result-item [item]="item">
+  </a>
+}
+
+@if (renderPageTrigger()) {
+  <div (uiInViewport)="paging($event)"></div>
+}
+```
+
+**Computed Signals:**
+
+| Signal | Type | Description |
+|--------|------|-------------|
+| `entity` | `ReturnSearchEntity \| undefined` | Current search entity for this process |
+| `entityItems` | `ReceiptListItem[]` | List of receipt items in current search |
+| `entityHits` | `number` | Total number of search results |
+| `entityStatus` | `ReturnSearchStatus` | Current status of search operation |
+| `renderItemList` | `boolean` | Whether to render the item list |
+| `renderPagingLoader` | `boolean` | Whether to show pagination loading indicator |
+| `renderSearchLoader` | `boolean` | Whether to show initial search loader |
+| `renderPageTrigger` | `boolean` | Whether to render pagination trigger element |
+| `mobileBreakpoint` | `boolean` | True when viewport is tablet size or below |
+| `showOrderByToolbarMobile` | `boolean` | Controls order-by toolbar visibility on mobile |
+
+**Methods:**
+
+#### `search(): void`
+
+Initiates a new search, clearing previous results.
+
+**Behavior:**
+- Commits filter changes
+- Clears existing results
+- Navigates to receipt if only 1 result
+
+#### `paging(inViewport: boolean): void`
+
+Handles infinite scroll pagination when trigger enters viewport.
+
+**Parameters:**
+- `inViewport: boolean` - Whether pagination trigger is visible
+
+**Behavior:**
+- Only triggers when element is in viewport
+- Appends results to existing list (clear: false)
+- Uses same filter query as original search
+
+**Example:**
+```html
+<!-- Pagination trigger -->
+@if (renderPageTrigger()) {
+  <div (uiInViewport)="paging($event)"></div>
+}
+```
+
+#### `navigate(path: (string | number)[]): void`
+
+Navigates to a route while preserving query parameters.
+
+**Parameters:**
+- `path: (string | number)[]` - Route segments
+
+**Behavior:**
+- Navigates relative to current route
+- Preserves all filter query parameters
+
+#### `ngAfterViewInit(): void`
+
+Lifecycle hook that restores scroll position after view initialization.
+
+---
+
+### ReturnSearchResultItemComponent
+
+Individual result item displaying receipt information.
+
+**Selector:** `oms-feature-return-search-result-item`
+
+**Inputs:**
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| `item` | `ReceiptListItem` | Yes | Receipt data to display |
+
+**Outputs:** None (clickable container handled by parent)
+
+**Template Structure:**
+```html
+<ui-client-row>
+  <ui-client-row-content>
+    <h3>{{ name() }}</h3>
+  </ui-client-row-content>
+
+  <ui-item-row-data>
+    <ui-item-row-data-row>
+      <ui-item-row-data-label>Belegdatum</ui-item-row-data-label>
+      <ui-item-row-data-value>{{ receiptDate() | date }}</ui-item-row-data-value>
+    </ui-item-row-data-row>
+    <!-- Receipt number, order number -->
+  </ui-item-row-data>
+
+  <ui-item-row-data>
+    <!-- Email, address -->
+  </ui-item-row-data>
+</ui-client-row>
+```
+
+**Computed Signals:**
+
+| Signal | Type | Description |
+|--------|------|-------------|
+| `name` | `string` | Formatted customer name (person or organization) |
+| `receiptDate` | `string \| undefined` | Date when receipt was printed |
+| `receiptNumber` | `string \| undefined` | Receipt number identifier |
+| `orderNumber` | `string \| undefined` | Order number identifier |
+| `email` | `string \| undefined` | Customer email from billing info |
+| `address` | `string` | Formatted address (ZIP + City) from billing or shipping |
+
+**Address Resolution Logic:**
+```typescript
+// Prefers billing address, falls back to shipping address
+address = computed(() => {
+  const address = this.item()?.billing?.address ?? this.item()?.shipping?.address;
+  return address ? [address.zipCode, address.city].join(' ') : '';
+});
+```
+
+**E2E Attributes:**
+```html
+<ui-client-row
+  data-what="search-result-item"
+  [attr.data-which]="receiptNumber()"
+>
+```
+
+**Usage:**
+```typescript
+@for (item of items; track item.id) {
+  <a [routerLink]="['receipt', item.id]">
+    <oms-feature-return-search-result-item [item]="item" />
+  </a>
+}
+```
+
+---
+
+### querySettingsResolverFn
+
+Route resolver that loads filter configuration from backend.
+
+**Type:** `ResolveFn<QuerySettingsDTO>`
+
+**Purpose:** Fetches query settings before route activation to configure filter system
+
+**Returns:** `QuerySettingsDTO` with filter field definitions
+
+**Usage:**
+```typescript
+{
+  path: '',
+  component: ReturnSearchComponent,
+  resolve: { querySettings: querySettingsResolverFn }
+}
+```
+
+**Data Flow:**
+1. Router activates route
+2. Resolver fetches query settings via `ReturnSearchService.querySettings()`
+3. Query settings passed to component via `ActivatedRoute.snapshot.data`
+4. Filter system configured with settings
+
+## Routing Configuration
+
+### Route Structure
+
+```typescript
+export const routes: Routes = [
+  {
+    path: '',
+    component: ReturnSearchComponent,
+    resolve: { querySettings: querySettingsResolverFn },
+    children: [
+      {
+        path: '',
+        component: ReturnSearchMainComponent
+      },
+      {
+        path: 'receipts',
+        component: ReturnSearchResultComponent,
+        data: { scrollPositionRestoration: true }
+      }
+    ]
+  },
+  {
+    path: 'receipt',
+    loadChildren: () =>
+      import('@isa/oms/feature/return-details').then((feat) => feat.routes)
+  },
+  {
+    path: 'process',
+    loadChildren: () =>
+      import('@isa/oms/feature/return-process').then((feat) => feat.routes)
+  }
+];
+```
+
+### Route Hierarchy
+
+```
+/returns
+├── ''                    → ReturnSearchMainComponent (search page)
+├── receipts              → ReturnSearchResultComponent (results list)
+├── receipt/:id           → Lazy-loaded return-details feature
+└── process/:id           → Lazy-loaded return-process feature
+```
+
+### Navigation Patterns
+
+#### From Search to Results
+
+```typescript
+// Automatic navigation based on result count
+onSearchCb = ({ data }) => {
+  if (data) {
+    if (data.result.length === 1) {
+      // Direct navigation to receipt details
+      return this.navigate(['receipt', data.result[0].id]);
+    }
+    // Multiple results - show list
+    return this.navigate(['receipts']);
+  }
+};
+```
+
+#### From Results to Receipt Details
+
+```html
+<!-- User clicks on result item -->
+<a [routerLink]="['../', 'receipt', item.id]">
+  <oms-feature-return-search-result-item [item]="item">
+</a>
+```
+
+#### Query Parameter Preservation
+
+All navigation preserves filter state:
+
+```typescript
+navigate(path: (string | number)[]) {
+  this.#router.navigate(path, {
+    relativeTo: this.#route,
+    queryParams: this._filterService.queryParams()  // Preserves filters
+  });
+}
+```
+
+### Scroll Position Restoration
+
+The results component uses scroll restoration:
+
+```typescript
+// Route data enables restoration
+{
+  path: 'receipts',
+  component: ReturnSearchResultComponent,
+  data: { scrollPositionRestoration: true }
+}
+
+// Component restores position after view init
+ngAfterViewInit(): void {
+  this.restoreScrollPosition();
+}
+```
+
+## Usage Examples
+
+### Basic Search Integration
+
+```typescript
+import { Component } from '@angular/core';
+
+@Component({
+  selector: 'app-returns-page',
+  template: `
+    <router-outlet></router-outlet>
+  `
+})
+export class ReturnsPageComponent {}
+
+// In app routing:
+const routes: Routes = [
+  {
+    path: 'returns',
+    component: ReturnsPageComponent,
+    loadChildren: () =>
+      import('@isa/oms/feature/return-search').then((m) => m.routes)
+  }
+];
+```
+
+### Triggering Search Programmatically
+
+While the library handles search internally, you can navigate to it with pre-filled filters:
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-dashboard',
+  template: `
+    <button (click)="searchByEmail('customer@example.com')">
+      Search by Email
+    </button>
+  `
+})
+export class DashboardComponent {
+  #router = inject(Router);
+
+  searchByEmail(email: string) {
+    this.#router.navigate(['/returns'], {
+      queryParams: { qs: email }  // Pre-fill search query
+    });
+  }
+}
+```
+
+### Handling Search Results
+
+The library automatically handles navigation, but you can monitor state:
+
+```typescript
+import { Component, inject, computed } from '@angular/core';
+import { ReturnSearchStore, ReturnSearchStatus } from '@isa/oms/data-access';
+import { injectTabId } from '@isa/core/tabs';
+
+@Component({
+  selector: 'app-custom-search',
+  template: `
+    @if (isSearching()) {
+      <p>Searching...</p>
+    }
+    @if (resultCount() > 0) {
+      <p>Found {{ resultCount() }} results</p>
+    }
+  `
+})
+export class CustomSearchComponent {
+  #returnSearchStore = inject(ReturnSearchStore);
+  #processId = injectTabId();
+
+  entity = computed(() => {
+    const processId = this.#processId();
+    return processId ? this.#returnSearchStore.getEntity(processId) : undefined;
+  });
+
+  isSearching = computed(() =>
+    this.entity()?.status === ReturnSearchStatus.Pending
+  );
+
+  resultCount = computed(() =>
+    this.entity()?.hits ?? 0
+  );
+}
+```
+
+### Custom Filter Configuration
+
+The filter system is configured via backend query settings:
+
+```typescript
+// Backend returns QuerySettingsDTO
+interface QuerySettingsDTO {
+  fields: Array<{
+    key: string;
+    label: string;
+    type: 'text' | 'date' | 'select';
+    group?: 'filter' | 'search';
+    options?: Array<{ value: string; label: string }>;
+  }>;
+  orderBy: Array<{
+    key: string;
+    label: string;
+    direction: 'asc' | 'desc';
+  }>;
+}
+
+// Example usage in ReturnSearchService:
+export class ReturnSearchService {
+  querySettings(): Promise<QuerySettingsDTO> {
+    return this.#http.get('/api/returns/query-settings').toPromise();
+  }
+}
+```
+
+### Implementing Custom Result Item
+
+You can extend the result item component:
+
+```typescript
+import { Component, input, computed } from '@angular/core';
+import { ReturnSearchResultItemComponent } from '@isa/oms/feature/return-search';
+
+@Component({
+  selector: 'app-custom-result-item',
+  template: `
+    <oms-feature-return-search-result-item [item]="item()">
+    </oms-feature-return-search-result-item>
+
+    <!-- Add custom content -->
+    <div class="custom-badge">
+      {{ customStatus() }}
+    </div>
+  `,
+  imports: [ReturnSearchResultItemComponent]
+})
+export class CustomResultItemComponent {
+  item = input.required<ReceiptListItem>();
+
+  customStatus = computed(() => {
+    const returnCount = this.item()?.returnCount ?? 0;
+    return returnCount > 0 ? 'Has Returns' : 'No Returns';
+  });
+}
+```
+
+### Responsive Breakpoint Handling
+
+The library uses responsive breakpoints for adaptive layouts:
+
+```typescript
+import { Component } from '@angular/core';
+import { breakpoint, Breakpoint } from '@isa/ui/layout';
+
+@Component({
+  selector: 'app-return-search-custom',
+  template: `
+    @if (isMobile()) {
+      <!-- Mobile layout -->
+      <ui-icon-button (click)="toggleSort()"></ui-icon-button>
+    } @else {
+      <!-- Desktop layout -->
+      <filter-order-by-toolbar></filter-order-by-toolbar>
+    }
+  `
+})
+export class ReturnSearchCustomComponent {
+  isMobile = breakpoint([Breakpoint.Tablet]);
+}
+```
+
+### Infinite Scroll Pagination
+
+Pagination is handled automatically via viewport detection:
+
+```html
+<!-- Pagination trigger in template -->
+@if (renderPageTrigger()) {
+  <div (uiInViewport)="paging($event)"></div>
+}
+```
+
+```typescript
+// Handling pagination
+paging(inViewport: boolean) {
+  if (!inViewport) return;
+
+  const processId = this.processId();
+  if (processId) {
+    this.returnSearchStore.search({
+      processId,
+      clear: false,          // Append results
+      query: this.#filterService.query()
+    });
+  }
+}
+```
+
+### Empty State Customization
+
+The library provides a default empty state, but you can customize it:
+
+```html
+@if (entityItems().length === 0 && !isSearching()) {
+  <ui-empty-state
+    title="Keine Rückgaben gefunden"
+    description="Versuchen Sie es mit einer anderen Suchbegriff."
+  >
+    <button (click)="clearFilters()">Filter zurücksetzen</button>
+  </ui-empty-state>
+}
+```
+
+## State Management
+
+### ReturnSearchStore
+
+The library uses `ReturnSearchStore` from `@isa/oms/data-access` for state management:
+
+```typescript
+interface ReturnSearchEntity {
+  processId: string;
+  status: ReturnSearchStatus;
+  query: Record<string, any>;
+  items: ReceiptListItem[];
+  hits: number;
+  page: number;
+  error?: string;
+}
+
+// Store methods
+class ReturnSearchStore {
+  // Search for receipts
+  search(params: {
+    processId: string;
+    query: Record<string, any>;
+    clear: boolean;
+    cb?: (result: CallbackResult) => void;
+  }): void;
+
+  // Get entity by process ID
+  getEntity(processId: string): ReturnSearchEntity | undefined;
+
+  // Clear entity
+  clearEntity(processId: string): void;
+}
+```
+
+### State Flow
+
+```
+User Action → Filter Service → Search Store → Backend API
+                                    ↓
+                              Store Update
+                                    ↓
+                          Component Re-render
+                                    ↓
+                         Navigation Decision
+```
+
+### Process ID Scoping
+
+Each browser tab maintains its own search state:
+
+```typescript
+// Tab 1: processId = "tab-123"
+// Search results stored in: entities['tab-123']
+
+// Tab 2: processId = "tab-456"
+// Search results stored in: entities['tab-456']
+
+// No collision between tabs
+```
+
+### Query State Synchronization
+
+Filter state is synchronized with URL query parameters:
+
+```
+URL: /returns/receipts?qs=john&date=2024-01-01&status=open
+
+Filter State:
+{
+  qs: 'john',
+  date: '2024-01-01',
+  status: 'open'
+}
+```
+
+**Benefits:**
+- Shareable search URLs
+- Browser back/forward navigation
+- Tab refresh preserves search
+- Bookmark support
+
+## Filter Integration
+
+### Filter System Architecture
+
+The library integrates with `@isa/shared/filter`:
+
+```typescript
+// Provider setup in root component
+providers: [
+  provideFilter(
+    withQuerySettingsFactory(querySettingsFactory),  // Load config
+    withQueryParamsSync()                            // Sync with URL
+  )
+]
+
+// Resolver loads configuration
+function querySettingsFactory() {
+  return inject(ActivatedRoute).snapshot.data['querySettings'];
+}
+```
+
+### Filter Input Types
+
+The filter system supports multiple input types:
+
+```typescript
+interface FilterInput {
+  key: string;          // Query parameter key
+  label: string;        // Display label
+  type: FilterInputType;
+  group?: 'search' | 'filter';
+  options?: FilterOption[];
+}
+
+type FilterInputType =
+  | 'text'              // Text input
+  | 'date'              // Date picker
+  | 'dateRange'         // Date range picker
+  | 'select'            // Dropdown
+  | 'multiSelect'       // Multi-select dropdown
+  | 'checkbox'          // Checkbox group
+  | 'radio';            // Radio group
+```
+
+### Search Bar Integration
+
+The search bar is configured with a specific input key:
+
+```html
+<filter-search-bar-input
+  inputKey="qs"                    <!-- Query string parameter -->
+  (triggerSearch)="onSearch()"     <!-- Search trigger -->
+  [appearance]="'results'"         <!-- Visual style -->
+></filter-search-bar-input>
+```
+
+**Query Parameter Mapping:**
+```
+URL: /returns?qs=john+doe
+       ↓
+Filter State: { qs: 'john doe' }
+       ↓
+Search Query: { qs: 'john doe' }
+```
+
+### Filter Menu Button
+
+Dynamic filter buttons are generated from query settings:
+
+```typescript
+// Component extracts filter-group inputs
+filterInputs = computed(() =>
+  this._filterService.inputs().filter(input => input.group === 'filter')
+);
+```
+
+```html
+<!-- Render filter buttons -->
+@for (filterInput of filterInputs(); track filterInput.key) {
+  <filter-input-menu-button
+    [filterInput]="filterInput"
+    (applied)="onSearch()"
+  ></filter-input-menu-button>
+}
+```
+
+### Order-By (Sort) Integration
+
+Sorting is handled by the order-by toolbar:
+
+```html
+<!-- Desktop: Always visible -->
+<filter-order-by-toolbar
+  (toggled)="search()"
+></filter-order-by-toolbar>
+
+<!-- Mobile: Toggle visibility -->
+@if (mobileBreakpoint() && showOrderByToolbarMobile()) {
+  <filter-order-by-toolbar
+    (toggled)="search()"
+  ></filter-order-by-toolbar>
+}
+```
+
+**Sort Query Parameters:**
+```
+URL: /returns/receipts?orderBy=receiptDate&direction=desc
+
+Sort State:
+{
+  orderBy: 'receiptDate',
+  direction: 'desc'
+}
+```
+
+### Commit Pattern
+
+Filters use a commit pattern to control when changes are applied:
+
+```typescript
+onSearch() {
+  // 1. Commit pending filter changes
+  this._filterService.commit();
+
+  // 2. Get committed query
+  const query = this._filterService.query();
+
+  // 3. Execute search
+  this._returnSearchStore.search({ processId, query, clear: true });
+}
+```
+
+**Benefits:**
+- User can modify multiple filters
+- Changes don't trigger search until committed
+- Rollback support for filter menu
+
+## Responsive Design
+
+### Breakpoint Strategy
+
+The library uses `@isa/ui/layout` breakpoints:
+
+```typescript
+import { breakpoint, Breakpoint } from '@isa/ui/layout';
+
+// Mobile breakpoint (tablet and below)
+mobileBreakpoint = breakpoint([Breakpoint.Tablet]);
+```
+
+**Breakpoint Definitions:**
+- `Tablet`: `(max-width: 1279px)` - Mobile and tablet
+- `Desktop`: `(min-width: 1280px) and (max-width: 1439px)` - Standard desktop
+- `DesktopL`: `(min-width: 1440px) and (max-width: 1919px)` - Large desktop
+- `DesktopXL`: `(min-width: 1920px)` - Extra large desktop
+
+### Mobile Adaptations
+
+#### Sort Toolbar Toggle
+
+```html
+<!-- Mobile: Icon button to toggle toolbar -->
+@if (mobileBreakpoint()) {
+  <ui-icon-button
+    (click)="showOrderByToolbarMobile.set(!showOrderByToolbarMobile())"
+    [class.active]="showOrderByToolbarMobile()"
+    name="isaActionSort"
+  ></ui-icon-button>
+}
+
+<!-- Mobile: Collapsible toolbar -->
+@if (mobileBreakpoint() && showOrderByToolbarMobile()) {
+  <filter-order-by-toolbar></filter-order-by-toolbar>
+}
+
+<!-- Desktop: Always visible inline toolbar -->
+@else {
+  <filter-order-by-toolbar></filter-order-by-toolbar>
+}
+```
+
+#### Responsive Grid Layout
+
+The main search component uses responsive grids:
+
+```scss
+:host {
+  @apply w-full
+         grid gap-16 grid-flow-row justify-center
+         desktop:grid-cols-[1fr,auto] desktop:gap-6;
+}
+```
+
+**Mobile:** Single column, vertical flow, 16px gap
+**Desktop:** Two-column layout, 6px gap
+
+### Tailwind Responsive Classes
+
+The library uses Tailwind CSS responsive utilities:
+
+```html
+<!-- Gap changes by breakpoint -->
+<div class="flex flex-col gap-5 isa-desktop:gap-6">
+
+<!-- Grid layout changes -->
+<div class="grid-flow-row desktop:grid-cols-[1fr,auto]">
+```
+
+### Deferred Rendering
+
+List items use Angular's `@defer` for performance:
+
+```html
+@for (item of entityItems(); track item.id) {
+  @defer (on viewport) {
+    <oms-feature-return-search-result-item [item]="item">
+  } @placeholder {
+    <ui-icon-button [pending]="true"></ui-icon-button>
+  }
+}
+```
+
+**Benefits:**
+- Only renders items when in viewport
+- Reduces initial render time
+- Improves scroll performance
+- Shows loading placeholder
+
+## Testing
+
+The library uses **Jest** with **Spectator** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test oms-feature-return-search --skip-nx-cache
+
+# Run tests with coverage
+npx nx test oms-feature-return-search --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test oms-feature-return-search --watch
+```
+
+### Test Structure
+
+Tests cover:
+
+- **Component rendering** - Verifies components render correctly
+- **Signal computations** - Tests computed signal logic
+- **User interactions** - Tests button clicks, form inputs, navigation
+- **Empty states** - Tests no-data scenarios
+- **Responsive behavior** - Tests breakpoint-dependent rendering
+- **Navigation logic** - Tests automatic navigation based on result count
+- **Filter integration** - Tests filter service interaction
+
+### Example Test
+
+```typescript
+import { createComponentFactory, Spectator } from '@ngneat/spectator/jest';
+import { ReturnSearchResultItemComponent } from './return-search-result-item.component';
+import { ReceiptListItem } from '@isa/oms/data-access';
+
+describe('ReturnSearchResultItemComponent', () => {
+  let spectator: Spectator<ReturnSearchResultItemComponent>;
+  const createComponent = createComponentFactory(
+    ReturnSearchResultItemComponent
+  );
+
+  const mockItem: ReceiptListItem = {
+    billing: {
+      person: { firstName: 'John', lastName: 'Doe' },
+      address: { zipCode: '12345', city: 'Berlin' },
+      communicationDetails: { email: 'john@example.com' }
+    },
+    receiptNumber: 'R-12345',
+    orderNumber: 'O-67890',
+    printedDate: '2024-01-15T10:00:00Z'
+  } as ReceiptListItem;
+
+  it('should render receipt information', () => {
+    spectator = createComponent({ props: { item: mockItem } });
+
+    expect(spectator.component.receiptNumber()).toBe('R-12345');
+    expect(spectator.component.orderNumber()).toBe('O-67890');
+    expect(spectator.component.email()).toBe('john@example.com');
+  });
+
+  it('should format address from billing', () => {
+    spectator = createComponent({ props: { item: mockItem } });
+
+    expect(spectator.component.address()).toBe('12345 Berlin');
+  });
+
+  it('should fallback to shipping address', () => {
+    const item = {
+      ...mockItem,
+      billing: { ...mockItem.billing, address: undefined },
+      shipping: { address: { zipCode: '54321', city: 'Munich' } }
+    } as ReceiptListItem;
+
+    spectator = createComponent({ props: { item } });
+
+    expect(spectator.component.address()).toBe('54321 Munich');
+  });
+});
+```
+
+### E2E Testing Attributes
+
+The library includes E2E testing attributes:
+
+```html
+<!-- Search input -->
+<filter-search-bar-input data-what="search-input">
+
+<!-- Result count -->
+<span data-what="result-count">{{ entityHits() }} Einträge</span>
+
+<!-- Result item -->
+<ui-client-row
+  data-what="search-result-item"
+  [attr.data-which]="receiptNumber()"
+>
+
+<!-- Loading indicators -->
+<ui-icon-button
+  data-what="load-spinner"
+  data-which="search"
+>
+
+<!-- Sort button (mobile) -->
+<ui-icon-button data-what="sort-button-mobile">
+```
+
+**E2E Test Example:**
+```typescript
+// Find and interact with search
+await page.locator('[data-what="search-input"]').fill('john doe');
+await page.locator('[data-what="search-input"]').press('Enter');
+
+// Verify results
+const resultCount = await page.locator('[data-what="result-count"]').textContent();
+expect(resultCount).toContain('Einträge');
+
+// Click first result
+await page.locator('[data-what="search-result-item"]').first().click();
+```
+
+## Architecture Notes
+
+### Current Architecture
+
+The library follows a feature-based architecture:
+
+```
+ReturnSearchComponent (Root)
+    ↓ provides Filter Context
+    ├─→ ReturnSearchMainComponent (Search Page)
+    │   ├─→ FilterService (injected)
+    │   ├─→ ReturnSearchStore (injected)
+    │   └─→ ReturnTaskListComponent (shared)
+    │
+    └─→ ReturnSearchResultComponent (Results Page)
+        ├─→ FilterService (injected)
+        ├─→ ReturnSearchStore (injected)
+        └─→ ReturnSearchResultItemComponent (list items)
+```
+
+### Dependency Flow
+
+```
+Feature Components
+       ↓
+  Filter Service (shared/filter)
+       ↓
+ReturnSearchStore (oms/data-access)
+       ↓
+ReturnSearchService (oms/data-access)
+       ↓
+  OMS API Client (generated/swagger)
+```
+
+### State Management Pattern
+
+The library uses **NgRx Signals** with entity-based state:
+
+```typescript
+// Store structure (conceptual)
+{
+  entities: {
+    'tab-123': {
+      processId: 'tab-123',
+      status: 'success',
+      items: [...],
+      hits: 42,
+      page: 1
+    },
+    'tab-456': {
+      processId: 'tab-456',
+      status: 'pending',
+      items: [],
+      hits: 0,
+      page: 0
+    }
+  }
+}
+```
+
+**Benefits:**
+- Multi-tab support
+- Automatic entity cleanup
+- Reactive updates via signals
+- Session persistence (if configured)
+
+### Filter Provider Pattern
+
+The library uses Angular's hierarchical dependency injection for filters:
+
+```typescript
+// Root component provides filter context
+@Component({
+  providers: [
+    provideFilter(
+      withQuerySettingsFactory(querySettingsFactory),
+      withQueryParamsSync()
+    )
+  ]
+})
+export class ReturnSearchComponent {}
+
+// Child components inject FilterService
+export class ReturnSearchMainComponent {
+  #filterService = inject(FilterService);  // Same instance
+}
+
+export class ReturnSearchResultComponent {
+  #filterService = inject(FilterService);  // Same instance
+}
+```
+
+### Navigation Strategy
+
+The library uses **intelligent navigation** based on result count:
+
+```typescript
+// Decision tree
+searchResults.length === 1
+  ? navigate(['receipt', results[0].id])      // Direct to details
+  : navigate(['receipts'])                    // Show list
+```
+
+**Benefits:**
+- Faster workflow for single results
+- No extra click required
+- Better user experience
+- Consistent behavior
+
+### Known Architectural Considerations
+
+#### 1. TODO: Extract Search Logic to Provider (Medium Priority)
+
+**Current State:**
+- Search logic embedded in component methods
+- No centralized search orchestration
+- Manual handling of cancel and fetching status
+
+**Proposed Refactoring:**
+```typescript
+// Create SearchProvider in FilterService
+class FilterService {
+  search(params: SearchParams): Observable<SearchResult> {
+    // Centralized search orchestration
+    // Automatic cancel previous search
+    // Loading state management
+  }
+
+  cancelSearch(): void {
+    // Cancel in-flight search
+  }
+}
+
+// Simplified component usage
+onSearch() {
+  this.#filterService.search({
+    query: this.#filterService.query()
+  }).subscribe(result => {
+    // Handle result
+  });
+}
+```
+
+**Impact:** Reduces component complexity, improves testability
+
+#### 2. Skeleton Loaders for Item Placeholders (Low Priority)
+
+**Current State:**
+- Loading spinner for deferred item placeholders
+- No visual structure hint
+
+**Proposed Enhancement:**
+```html
+@defer (on viewport) {
+  <oms-feature-return-search-result-item [item]="item">
+} @placeholder {
+  <!-- Replace spinner with skeleton -->
+  <ui-skeleton-loader [layout]="'client-row'">
+</ui-skeleton-loader>
+}
+```
+
+**Impact:** Better perceived performance, clearer loading state
+
+#### 3. Scroll Restoration Configuration (Low Priority)
+
+**Current State:**
+- Scroll restoration hardcoded in route data
+- No component-level control
+
+**Proposed Enhancement:**
+```typescript
+// Make restoration configurable
+@Input() scrollRestoration: boolean = true;
+
+ngAfterViewInit(): void {
+  if (this.scrollRestoration) {
+    this.restoreScrollPosition();
+  }
+}
+```
+
+**Impact:** More flexible for different use cases
+
+### Performance Considerations
+
+1. **Deferred Rendering** - List items load on viewport entry
+2. **Infinite Scroll** - Pagination reduces initial load time
+3. **Computed Signals** - Efficient reactive updates
+4. **Track By** - Angular change detection optimization
+5. **OnPush Change Detection** - All components use OnPush
+6. **Lazy Loaded Routes** - Receipt details and process routes lazy loaded
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Search Debouncing** - Debounce search input to reduce API calls
+2. **Result Caching** - Cache search results per query
+3. **Advanced Filtering** - Multi-select, date range, numeric range filters
+4. **Export Results** - Export search results to CSV/Excel
+5. **Saved Searches** - Allow users to save common searches
+6. **Search History** - Show recent searches
+7. **Keyboard Navigation** - Arrow keys to navigate results
+8. **Bulk Actions** - Select multiple results for bulk operations
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework (v20.1.2)
+- `@angular/common` - Common Angular utilities
+- `@angular/router` - Angular routing
+- `@isa/oms/data-access` - OMS data access layer with `ReturnSearchStore` and `ReturnSearchService`
+- `@isa/oms/shared/task-list` - Return task list component
+- `@isa/shared/filter` - Filter system with search bar and filter inputs
+- `@isa/ui/buttons` - Button components
+- `@isa/ui/empty-state` - Empty state component
+- `@isa/ui/item-rows` - Client row and item row data components
+- `@isa/ui/layout` - Layout utilities with breakpoint service
+- `@isa/ui/tooltip` - Tooltip components
+- `@isa/core/tabs` - Tab ID management
+- `@isa/utils/scroll-position` - Scroll position restoration utility
+- `@isa/icons` - Icon library
+- `@ng-icons/core` - Icon provider
+- `@generated/swagger/oms-api` - Generated OMS API client
+
+### Development Dependencies
+
+- `@nx/jest` - Jest test executor
+- `@ngneat/spectator` - Testing utilities
+- `jest` - Test framework
+- `typescript` - TypeScript compiler
+
+### Path Alias
+
+Import from: `@isa/oms/feature/return-search`
+
+**Example:**
+```typescript
+import { routes } from '@isa/oms/feature/return-search';
+```
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/oms/feature/return-summary/README.md b/libs/oms/feature/return-summary/README.md
index 9bd146355..8b0c29ed5 100644
--- a/libs/oms/feature/return-summary/README.md
+++ b/libs/oms/feature/return-summary/README.md
@@ -1,7 +1,1272 @@
-# oms-feature-return-summary
+# @isa/oms/feature/return-summary
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive Angular feature library for displaying and confirming return process summaries in the Order Management System (OMS). This library provides a review interface where users can inspect all items being returned, verify return details, and complete the return process with receipt printing.
 
-## Running unit tests
+## Overview
 
-Run `nx test oms-feature-return-summary` to execute the unit tests.
+The Return Summary feature library is a critical component in the OMS return workflow. It displays all items selected for return in a given process, shows their return conditions and reasons, and provides a confirmation interface to complete the return and generate return receipts. The library integrates tightly with the return process state management and handles the final step before items are officially returned to inventory.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Routing and Navigation](#routing-and-navigation)
+- [Component Architecture](#component-architecture)
+- [State Management](#state-management)
+- [Testing](#testing)
+- [Best Practices](#best-practices)
+- [Dependencies](#dependencies)
+
+## Features
+
+- **Return Process Summary** - Displays all items in a return process with complete details
+- **Product Information Display** - Shows product names, images, and identification
+- **Return Details Visualization** - Presents item condition, return reason, and customer comments
+- **Eligibility Validation** - Verifies each item is eligible for return before processing
+- **Process Completion** - Completes return process and generates return receipts
+- **Receipt Printing** - Automatically triggers receipt printing after successful return
+- **Navigation Integration** - Seamless routing to review screens after completion
+- **Loading States** - Visual feedback during asynchronous operations
+- **Error Handling** - Comprehensive error logging and user feedback
+- **E2E Testing Support** - Full data-* attribute coverage for automated testing
+- **Responsive Design** - Tailwind CSS-based layout with grid system
+- **OnPush Change Detection** - Optimized performance with reactive signals
+
+## Quick Start
+
+### 1. Import Routes
+
+```typescript
+import { Routes } from '@angular/router';
+
+export const routes: Routes = [
+  {
+    path: 'return/:tabId/summary',
+    loadChildren: () =>
+      import('@isa/oms/feature/return-summary').then(m => m.routes)
+  }
+];
+```
+
+### 2. Navigate to Summary
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-return-process',
+  template: '...'
+})
+export class ReturnProcessComponent {
+  #router = inject(Router);
+
+  async goToSummary(tabId: number): Promise<void> {
+    await this.#router.navigate(['/return', tabId, 'summary']);
+  }
+}
+```
+
+### 3. Process Completion Flow
+
+The component automatically handles:
+- Loading return process items from the store
+- Displaying return details for each item
+- Completing the return when user confirms
+- Navigating to review screen after success
+
+## Core Concepts
+
+### Return Process Workflow
+
+The return summary is the penultimate step in the return workflow:
+
+1. **Return Search** - Find receipt and items to return
+2. **Return Details Collection** - Gather item condition, reason, comments
+3. **Return Summary** (This Library) - Review and confirm all details
+4. **Return Review** - Display completed return receipts
+
+### Return Process Data Structure
+
+Each return process contains comprehensive information:
+
+```typescript
+interface ReturnProcess {
+  id: number;                           // Unique return process ID
+  processId: number;                    // Parent process ID (groups multiple returns)
+  receiptId: number;                    // Original receipt ID
+  receiptItem: ReceiptItem;             // Item being returned with product details
+  receiptDate: string | undefined;      // Original purchase date
+  answers: Record<string, unknown>;     // Return questionnaire answers
+  productCategory: string;              // Product category (affects questions)
+  quantity: number;                     // Quantity being returned
+  returnReceipt?: Receipt;              // Generated return receipt (set after completion)
+}
+```
+
+### Eligibility States
+
+Items are validated for return eligibility:
+
+```typescript
+enum EligibleForReturnState {
+  Eligible = 'eligible',              // Can be returned
+  NotEligible = 'ineligible',         // Cannot be returned
+  Conditional = 'conditional'         // May be returned with conditions
+}
+
+interface EligibleForReturn {
+  state: EligibleForReturnState;
+  reason?: string;                     // Explanation if not eligible
+}
+```
+
+### Return Information Display
+
+Return details are collected from the return process answers:
+
+- **Item Condition** - Physical state of the item (e.g., "Unopened", "Used")
+- **Return Reason** - Why the customer is returning (e.g., "Defective", "Wrong item")
+- **Return Details** - Specific damage or issues (e.g., "Case damaged", "Missing accessories")
+- **Other Product** - If wrong item was delivered, shows the received item's EAN
+- **Comment** - Free-text customer explanation
+
+## API Reference
+
+### ReturnSummaryComponent
+
+Main component for displaying the return summary and handling process completion.
+
+#### Component Metadata
+
+```typescript
+@Component({
+  selector: 'oms-feature-return-summary',
+  templateUrl: './return-summary.component.html',
+  styleUrls: ['./return-summary.component.scss'],
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  imports: [ReturnSummaryItemComponent, ButtonComponent, NgIcon],
+  providers: [provideIcons({ isaActionChevronLeft })]
+})
+```
+
+#### Properties
+
+##### `processId: Signal<number>`
+
+The active tab/process ID extracted from the route.
+
+```typescript
+const processId = this.processId();  // e.g., 42
+```
+
+##### `returnProcesses: Signal<ReturnProcess[]>`
+
+Computed signal containing all return processes for the current processId.
+
+```typescript
+const items = this.returnProcesses();  // Array of ReturnProcess objects
+console.log(`${items.length} items to return`);
+```
+
+##### `returnItemsAndPrintReciptStatus: WritableSignal<undefined | 'pending' | 'success' | 'error'>`
+
+Tracks the current status of the return and print operation.
+
+**States:**
+- `undefined` - Initial state, no operation started
+- `'pending'` - Operation in progress
+- `'success'` - Operation completed successfully
+- `'error'` - Operation failed
+
+```typescript
+const status = this.returnItemsAndPrintReciptStatus();
+if (status === 'pending') {
+  console.log('Processing return...');
+}
+```
+
+##### `returnItemsAndPrintReciptStatusPending: Signal<boolean>`
+
+Computed signal that returns true when the operation is pending.
+
+```typescript
+const isProcessing = this.returnItemsAndPrintReciptStatusPending();
+// Used to disable buttons during processing
+```
+
+##### `location: Location`
+
+Angular Location service for navigation (back button functionality).
+
+```typescript
+this.location.back();  // Navigate to previous page
+```
+
+#### Methods
+
+##### `async returnItemsAndPrintRecipt(): Promise<void>`
+
+Completes the return process, generates return receipts, and navigates to the review screen.
+
+**Workflow:**
+1. Checks if operation is already in progress (prevents double-submit)
+2. Sets status to 'pending'
+3. Calls `ReturnProcessService.completeReturnProcess()` with all return processes
+4. Updates status based on success/failure
+5. Stores completed receipts in `ReturnProcessStore`
+6. Navigates to '../review' route on success
+7. Logs errors if operation fails
+
+**Example:**
+```typescript
+await component.returnItemsAndPrintRecipt();
+// After successful completion:
+// - Return receipts are created
+// - State is updated with completed receipts
+// - User is navigated to review screen
+```
+
+**Error Handling:**
+- Logs warnings if called while already pending
+- Logs errors with full context on failure
+- Sets status to 'error' on exception
+- Status remains visible to user (success button hidden, error stays pending)
+
+### ReturnSummaryItemComponent
+
+Displays a single return process item with product details and return information.
+
+#### Component Metadata
+
+```typescript
+@Component({
+  selector: 'oms-feature-return-summary-item',
+  templateUrl: './return-summary-item.component.html',
+  styleUrls: ['./return-summary-item.component.scss'],
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  imports: [ReturnProductInfoComponent, NgIcon, IconButtonComponent],
+  providers: [provideIcons({ isaActionChevronRight, isaActionEdit, isaActionClose })],
+  host: {
+    'data-what': 'list-item',
+    'data-which': 'return-process-item',
+    '[attr.data-receipt-id]': 'returnProcess()?.receiptId',
+    '[attr.data-return-item-id]': 'returnProcess()?.returnItem?.id'
+  }
+})
+```
+
+#### Inputs
+
+##### `returnProcess: InputSignal<ReturnProcess>` (required)
+
+The return process object containing all information about the item being returned.
+
+```typescript
+<oms-feature-return-summary-item
+  [returnProcess]="returnProcessItem"
+></oms-feature-return-summary-item>
+```
+
+##### `returnItemsAndPrintReciptPending: InputSignal<boolean>` (optional, default: false)
+
+Whether the parent completion operation is in progress. Used to disable edit button during processing.
+
+```typescript
+<oms-feature-return-summary-item
+  [returnProcess]="item"
+  [returnItemsAndPrintReciptPending]="isPending()"
+></oms-feature-return-summary-item>
+```
+
+#### Properties
+
+##### `eligibleForReturn: Signal<EligibleForReturn | undefined>`
+
+Computes the return eligibility for the current return process.
+
+```typescript
+const eligibility = this.eligibleForReturn();
+if (eligibility?.state === EligibleForReturnState.NotEligible) {
+  console.log(`Cannot return: ${eligibility.reason}`);
+}
+```
+
+##### `returnInfos: Signal<string[]>`
+
+Computes an array of human-readable return information strings.
+
+**Includes:**
+- Item condition (except for Tolino products)
+- Return reason (except for Tolino products)
+- Mapped return details (damage, missing items, etc.)
+- Incorrect product delivered (shows EAN)
+- Customer comments
+
+**Special Handling:**
+- Tolino products skip condition/reason display
+- Duplicates are automatically removed
+- Empty values are filtered out
+
+```typescript
+const infos = this.returnInfos();
+// Example output:
+// [
+//   "Opened and used",
+//   "Defective",
+//   "Display damaged: Yes",
+//   "Missing accessories: Power cable",
+//   "Screen has scratches"
+// ]
+```
+
+##### `location: Location`
+
+Angular Location service for back navigation (edit button).
+
+```typescript
+this.location.back();  // Returns to return details screen
+```
+
+## Usage Examples
+
+### Basic Implementation
+
+```typescript
+import { Routes } from '@angular/router';
+
+export const returnRoutes: Routes = [
+  {
+    path: 'return/:tabId',
+    children: [
+      {
+        path: 'summary',
+        loadChildren: () =>
+          import('@isa/oms/feature/return-summary').then(m => m.routes)
+      }
+    ]
+  }
+];
+```
+
+### Programmatic Navigation
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-return-workflow',
+  template: `
+    <button (click)="proceedToSummary()">Review Return</button>
+  `
+})
+export class ReturnWorkflowComponent {
+  #router = inject(Router);
+
+  async proceedToSummary(): Promise<void> {
+    // Navigate to summary for tab ID 42
+    await this.#router.navigate(['/return', 42, 'summary']);
+  }
+}
+```
+
+### Handling Return Completion
+
+```typescript
+import { Component, inject, OnInit } from '@angular/core';
+import { ReturnProcessStore } from '@isa/oms/data-access';
+import { Router, ActivatedRoute } from '@angular/router';
+
+@Component({
+  selector: 'app-return-completion-handler',
+  template: '...'
+})
+export class ReturnCompletionHandlerComponent implements OnInit {
+  #returnStore = inject(ReturnProcessStore);
+  #router = inject(Router);
+  #route = inject(ActivatedRoute);
+
+  ngOnInit(): void {
+    // After completion, user is redirected to '../review'
+    // which resolves to '/return/:tabId/review'
+
+    // Access completed receipts from the store
+    const completedReceipts = this.#returnStore.entities()
+      .filter(p => p.returnReceipt !== undefined)
+      .map(p => p.returnReceipt);
+
+    console.log(`${completedReceipts.length} returns completed`);
+  }
+}
+```
+
+### Custom Navigation Flow
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { Router, ActivatedRoute } from '@angular/router';
+import { Location } from '@angular/common';
+
+@Component({
+  selector: 'app-custom-return-flow',
+  template: `
+    <oms-feature-return-summary></oms-feature-return-summary>
+    <button (click)="cancelReturn()">Cancel</button>
+  `
+})
+export class CustomReturnFlowComponent {
+  #router = inject(Router);
+  #route = inject(ActivatedRoute);
+  #location = inject(Location);
+
+  cancelReturn(): void {
+    // Option 1: Navigate back
+    this.#location.back();
+
+    // Option 2: Navigate to specific route
+    this.#router.navigate(['/return/search']);
+
+    // Option 3: Navigate relative to current route
+    this.#router.navigate(['../../search'], {
+      relativeTo: this.#route
+    });
+  }
+}
+```
+
+### Error Handling
+
+```typescript
+import { Component, inject, effect } from '@angular/core';
+import { ReturnSummaryComponent } from '@isa/oms/feature/return-summary';
+import { ToastService } from '@isa/ui/notifications';
+
+@Component({
+  selector: 'app-return-with-error-handling',
+  template: `
+    <oms-feature-return-summary></oms-feature-return-summary>
+  `
+})
+export class ReturnWithErrorHandlingComponent {
+  #toastService = inject(ToastService);
+  returnSummary = inject(ReturnSummaryComponent);
+
+  constructor() {
+    // Monitor return status and show notifications
+    effect(() => {
+      const status = this.returnSummary.returnItemsAndPrintReciptStatus();
+
+      if (status === 'success') {
+        this.#toastService.success('Return completed successfully');
+      } else if (status === 'error') {
+        this.#toastService.error('Failed to complete return. Please try again.');
+      }
+    });
+  }
+}
+```
+
+### Accessing Return Process Data
+
+```typescript
+import { Component, inject, computed } from '@angular/core';
+import { ReturnProcessStore } from '@isa/oms/data-access';
+import { injectTabId } from '@isa/core/tabs';
+
+@Component({
+  selector: 'app-return-summary-analytics',
+  template: '...'
+})
+export class ReturnSummaryAnalyticsComponent {
+  #returnStore = inject(ReturnProcessStore);
+  processId = injectTabId();
+
+  // Get all returns for current process
+  currentReturns = computed(() => {
+    const pid = this.processId();
+    return this.#returnStore.entities()
+      .filter(p => p.processId === pid);
+  });
+
+  // Calculate total items being returned
+  totalItems = computed(() => {
+    return this.currentReturns()
+      .reduce((sum, p) => sum + (p.quantity || 1), 0);
+  });
+
+  // Group by product category
+  byCategory = computed(() => {
+    const returns = this.currentReturns();
+    return returns.reduce((acc, p) => {
+      const category = p.productCategory || 'Unknown';
+      acc[category] = (acc[category] || 0) + 1;
+      return acc;
+    }, {} as Record<string, number>);
+  });
+}
+```
+
+## Routing and Navigation
+
+### Route Configuration
+
+The library exports a `routes` constant that defines its routing structure:
+
+```typescript
+// libs/oms/feature/return-summary/src/lib/routes.ts
+export const routes: Routes = [
+  {
+    path: '',
+    component: ReturnSummaryComponent
+  },
+  {
+    path: 'review',
+    loadChildren: () =>
+      import('@isa/oms/feature/return-review').then(feat => feat.routes)
+  }
+];
+```
+
+### Integration in Application
+
+**Parent Route Setup:**
+
+```typescript
+// In app routing or OMS feature routing
+const omsRoutes: Routes = [
+  {
+    path: 'return/:tabId',
+    children: [
+      {
+        path: 'search',
+        loadChildren: () => import('@isa/oms/feature/return-search')
+          .then(m => m.routes)
+      },
+      {
+        path: 'details',
+        loadChildren: () => import('@isa/oms/feature/return-details')
+          .then(m => m.routes)
+      },
+      {
+        path: 'summary',
+        loadChildren: () => import('@isa/oms/feature/return-summary')
+          .then(m => m.routes)
+      }
+    ]
+  }
+];
+```
+
+### URL Structure
+
+- **Summary View**: `/return/:tabId/summary`
+  - Example: `/return/42/summary`
+
+- **Review View** (after completion): `/return/:tabId/summary/review`
+  - Example: `/return/42/summary/review`
+  - Loads `@isa/oms/feature/return-review` lazily
+
+### Navigation Flow
+
+```
+┌─────────────────┐
+│ Return Search   │
+│ /return/:id     │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ Return Details  │
+│ /return/:id/... │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ Return Summary  │◄────── You are here
+│ /return/:id/    │        (This Library)
+│      summary    │
+└────────┬────────┘
+         │ (Complete Return)
+         ▼
+┌─────────────────┐
+│ Return Review   │
+│ /return/:id/    │
+│  summary/review │
+└─────────────────┘
+```
+
+### Back Navigation
+
+Both components use Angular's `Location` service for back navigation:
+
+```typescript
+import { Location } from '@angular/common';
+
+@Component({ ... })
+class ReturnSummaryComponent {
+  location = inject(Location);
+
+  goBack(): void {
+    this.location.back();  // Returns to previous page in history
+  }
+}
+```
+
+**Use Cases:**
+- **Back Button** (ReturnSummaryComponent): Returns to return details collection screen
+- **Edit Button** (ReturnSummaryItemComponent): Returns to edit specific item details
+
+### Relative Navigation
+
+The component uses relative navigation for the review route:
+
+```typescript
+await this.#router.navigate(['../', 'review'], {
+  relativeTo: this.#activatedRoute
+});
+
+// From: /return/42/summary
+// To:   /return/42/summary/review
+```
+
+## Component Architecture
+
+### Component Hierarchy
+
+```
+ReturnSummaryComponent
+├── Back Button (navigates to previous page)
+├── Heading ("Zusammenfassung überprüfen")
+├── Return Items Container
+│   └── ReturnSummaryItemComponent (for each return process)
+│       ├── ReturnProductInfoComponent (product display)
+│       ├── Return Information List (conditions, reasons, etc.)
+│       └── Edit Button (navigates back to edit)
+└── Complete Button ("Artikel zurückgeben und drucken")
+```
+
+### Standalone Component Pattern
+
+Both components use Angular's standalone component architecture:
+
+```typescript
+@Component({
+  selector: 'oms-feature-return-summary',
+  imports: [
+    ReturnSummaryItemComponent,    // Child component
+    ButtonComponent,               // UI library
+    NgIcon                         // Icon library
+  ],
+  providers: [
+    provideIcons({ isaActionChevronLeft })  // Icon registration
+  ]
+})
+```
+
+**Benefits:**
+- No NgModule required
+- Explicit dependency management
+- Better tree-shaking
+- Easier testing
+
+### Change Detection Strategy
+
+Both components use `OnPush` change detection for optimal performance:
+
+```typescript
+@Component({
+  changeDetection: ChangeDetectionStrategy.OnPush
+})
+```
+
+**Implications:**
+- Components only re-render when:
+  - Input signals change
+  - Computed signals update
+  - Async events trigger (button clicks)
+- Better performance with large lists
+- Requires reactive patterns (signals, observables)
+
+### Styling Architecture
+
+**Host Styling:**
+
+```scss
+// return-summary.component.scss
+:host {
+  @apply grid grid-flow-row gap-6 justify-stretch mt-6 relative;
+}
+```
+
+**Item Styling:**
+
+```scss
+// return-summary-item.component.scss
+:host {
+  @apply grid grid-cols-[1fr,1fr,auto] p-6 text-isa-secondary-900 items-center;
+}
+```
+
+**Layout Structure:**
+- Summary uses vertical grid layout (grid-flow-row)
+- Items use 3-column grid: [product info | return details | edit button]
+- Tailwind utility classes for spacing and alignment
+- ISA design system colors and typography
+
+### E2E Testing Attributes
+
+Complete data attribute coverage for automated testing:
+
+**ReturnSummaryComponent:**
+```html
+<!-- Heading -->
+<h1 data-what="heading" data-which="return-summary-title">
+
+<!-- Container -->
+<div data-what="container" data-which="return-items-list">
+
+<!-- List Items -->
+<oms-feature-return-summary-item
+  data-what="list-item"
+  data-which="return-process-item"
+  [attr.data-item-id]="item.id"
+  [attr.data-item-category]="item.productCategory">
+
+<!-- Complete Button -->
+<button data-what="button" data-which="return-and-print">
+```
+
+**ReturnSummaryItemComponent:**
+```html
+<!-- Host attributes (dynamic) -->
+<component
+  data-what="list-item"
+  data-which="return-process-item"
+  [attr.data-receipt-id]="returnProcess()?.receiptId"
+  [attr.data-return-item-id]="returnProcess()?.returnItem?.id">
+
+<!-- Return info list -->
+<ul data-what="list" data-which="return-infos">
+  <li data-what="list-item"
+      data-which="return-info"
+      [attr.data-return-info]="returnInfo"
+      [attr.data-info-index]="$index">
+
+<!-- Edit button -->
+<button data-what="button" data-which="edit-return-item">
+```
+
+## State Management
+
+### ReturnProcessStore Integration
+
+The component relies on NgRx Signals-based state management:
+
+```typescript
+import { ReturnProcessStore } from '@isa/oms/data-access';
+
+@Component({ ... })
+class ReturnSummaryComponent {
+  #returnProcessStore = inject(ReturnProcessStore);
+
+  // Reactive query: filters entities by processId
+  returnProcesses = computed<ReturnProcess[]>(() => {
+    const processId = this.processId();
+    return this.#returnProcessStore
+      .entities()
+      .filter(p => p.processId === processId);
+  });
+}
+```
+
+### Store Methods Used
+
+**Reading State:**
+
+```typescript
+// Get all return process entities
+this.#returnProcessStore.entities()  // Signal<ReturnProcess[]>
+```
+
+**Writing State:**
+
+```typescript
+// Mark processes as finished with generated receipts
+this.#returnProcessStore.finishProcess(returnReceipts: Receipt[])
+```
+
+### Process Lifecycle
+
+```
+┌─────────────────────────────────────────────────────────┐
+│ Store State: ReturnProcess[]                            │
+├─────────────────────────────────────────────────────────┤
+│ Initial State:                                          │
+│   - Multiple ReturnProcess entities                     │
+│   - Grouped by processId                                │
+│   - Contains answers, receiptItem, productCategory      │
+│   - returnReceipt is undefined                          │
+└────────────────────┬────────────────────────────────────┘
+                     │
+                     │ User clicks "Complete Return"
+                     ▼
+┌─────────────────────────────────────────────────────────┐
+│ ReturnProcessService.completeReturnProcess()            │
+├─────────────────────────────────────────────────────────┤
+│ - API call to OMS backend                               │
+│ - Generates return receipts                             │
+│ - Prints receipts                                       │
+│ - Returns Receipt[] array                               │
+└────────────────────┬────────────────────────────────────┘
+                     │
+                     │ Success: Receipt[] returned
+                     ▼
+┌─────────────────────────────────────────────────────────┐
+│ Store.finishProcess(receipts)                           │
+├─────────────────────────────────────────────────────────┤
+│ Updates State:                                          │
+│   - Matches receipts to ReturnProcess entities          │
+│   - Sets returnReceipt property on each                 │
+│   - Marks processes as completed                        │
+└────────────────────┬────────────────────────────────────┘
+                     │
+                     │ Navigate to review
+                     ▼
+┌─────────────────────────────────────────────────────────┐
+│ ReturnReview Screen                                     │
+│ - Displays completed returnReceipts                     │
+│ - Shows confirmation to user                            │
+└─────────────────────────────────────────────────────────┘
+```
+
+### Tab ID Management
+
+Uses `@isa/core/tabs` for process ID extraction:
+
+```typescript
+import { injectTabId } from '@isa/core/tabs';
+
+@Component({ ... })
+class ReturnSummaryComponent {
+  // Automatically extracts tabId from route params
+  processId = injectTabId();  // Signal<number>
+}
+```
+
+**Benefits:**
+- Centralized tab/process ID management
+- Type-safe signal-based access
+- Automatic route parameter tracking
+- Consistent across OMS features
+
+## Testing
+
+The library uses **Jest** with **Spectator** for unit testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test oms-feature-return-summary --skip-nx-cache
+
+# Run tests with coverage
+npx nx test oms-feature-return-summary --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test oms-feature-return-summary --watch
+```
+
+### Test Structure
+
+The library includes comprehensive unit tests covering:
+
+- **Component creation** - Verifies component instantiation
+- **State filtering** - Tests processId-based filtering of return processes
+- **Child component rendering** - Validates ReturnSummaryItemComponent is rendered correctly
+- **Input binding** - Tests data flow to child components
+- **E2E attributes** - Validates all data-* attributes are properly set
+- **User interactions** - Tests button clicks and navigation
+- **Return information** - Tests computed return details display
+- **Eligibility checking** - Tests return eligibility validation
+- **Navigation** - Tests back button and edit functionality
+
+### Example Test: E2E Attributes
+
+```typescript
+it('should have proper E2E testing attributes', () => {
+  // Arrange
+  const mockReturnProcesses: ReturnProcess[] = [
+    { id: 1, processId: 1, productCategory: 'Electronics' } as ReturnProcess,
+    { id: 2, processId: 1, productCategory: 'Books' } as ReturnProcess
+  ];
+
+  jest.spyOn(spectator.component, 'returnProcesses')
+    .mockReturnValue(mockReturnProcesses);
+
+  // Act
+  spectator.detectChanges();
+
+  // Assert
+  const heading = spectator.query('[data-what="heading"]');
+  expect(heading).toHaveAttribute('data-which', 'return-summary-title');
+
+  const listItems = spectator.queryAll('oms-feature-return-summary-item');
+  expect(listItems[0]).toHaveAttribute('data-item-id', '1');
+  expect(listItems[0]).toHaveAttribute('data-item-category', 'Electronics');
+  expect(listItems[1]).toHaveAttribute('data-item-id', '2');
+  expect(listItems[1]).toHaveAttribute('data-item-category', 'Books');
+
+  const button = spectator.query('[data-which="return-and-print"]');
+  expect(button).toBeTruthy();
+});
+```
+
+### Example Test: Return Information Display
+
+```typescript
+it('should provide correct return information array', () => {
+  // Arrange
+  const mockReturnInfo = {
+    itemCondition: 'Used',
+    returnReason: 'Defective',
+    returnDetails: { [ReturnProcessQuestionKey.CaseDamaged]: 'Yes' },
+    otherProduct: { ean: '1234567890123' } as Product,
+    comment: 'Screen has scratches'
+  };
+
+  jest.spyOn(returnProcessService, 'getReturnInfo')
+    .mockReturnValue(mockReturnInfo);
+
+  spectator.setInput('returnProcess', mockReturnProcess);
+  spectator.detectChanges();
+
+  // Act
+  const actualInfos = spectator.component.returnInfos();
+
+  // Assert
+  expect(actualInfos).toEqual([
+    'Used',
+    'Defective',
+    'Gehäuse beschädigt: Yes',
+    'Geliefert wurde: 1234567890123',
+    'Screen has scratches'
+  ]);
+});
+```
+
+### Mocking Strategy
+
+**ReturnSummaryComponent Tests:**
+```typescript
+const createComponent = createComponentFactory({
+  component: ReturnSummaryComponent,
+  imports: [MockComponent(ReturnSummaryItemComponent)],
+  mocks: [ReturnProcessStore, ReturnProcessService, ActivatedRoute, Router]
+});
+```
+
+**ReturnSummaryItemComponent Tests:**
+```typescript
+const createComponent = createRoutingFactory({
+  component: ReturnSummaryItemComponent,
+  declarations: MockComponents(
+    ReturnProductInfoComponent,
+    NgIcon,
+    IconButtonComponent
+  ),
+  providers: [
+    MockProvider(ReturnProcessService, {
+      getReturnInfo: jest.fn(),
+      eligibleForReturn: jest.fn().mockReturnValue({ state: 'eligible' })
+    }),
+    MockProvider(Location, { back: jest.fn() })
+  ]
+});
+```
+
+### Coverage Requirements
+
+The tests ensure coverage of:
+- All public methods and properties
+- All computed signals and their logic
+- All user interaction handlers
+- All conditional template rendering
+- All E2E testing attributes
+- All error scenarios
+
+## Best Practices
+
+### 1. Use Computed Signals for Derived State
+
+```typescript
+// ✅ Good: Reactive computed signal
+returnProcesses = computed<ReturnProcess[]>(() => {
+  const processId = this.processId();
+  return this.#returnProcessStore
+    .entities()
+    .filter(p => p.processId === processId);
+});
+
+// ❌ Bad: Manual filtering in template
+// {{ store.entities() | filterByProcessId: processId() }}
+```
+
+### 2. Prevent Double-Submit with Status Checking
+
+```typescript
+async returnItemsAndPrintRecipt() {
+  // ✅ Good: Check if already processing
+  if (this.returnItemsAndPrintReciptStatus() === 'pending') {
+    this.#logger.warn('Return process already in progress');
+    return;
+  }
+
+  try {
+    this.returnItemsAndPrintReciptStatus.set('pending');
+    // ... process return
+  } catch (error) {
+    this.returnItemsAndPrintReciptStatus.set('error');
+  }
+}
+
+// ❌ Bad: No duplicate check, user can click multiple times
+```
+
+### 3. Comprehensive Error Logging
+
+```typescript
+// ✅ Good: Contextual error logging
+this.#logger.error(
+  'Error completing return process',
+  error as Error,
+  () => ({
+    function: 'returnItemsAndPrintRecipt',
+    processCount: this.returnProcesses().length,
+    processId: this.processId()
+  })
+);
+
+// ❌ Bad: Generic console.error
+console.error('Error:', error);
+```
+
+### 4. Use E2E Attributes Consistently
+
+```typescript
+// ✅ Good: Complete E2E attribute coverage
+<button
+  data-what="button"
+  data-which="return-and-print"
+  [disabled]="returnItemsAndPrintReciptStatusPending()"
+  (click)="returnItemsAndPrintRecipt()">
+
+// ❌ Bad: Missing E2E attributes
+<button
+  [disabled]="isPending"
+  (click)="submit()">
+```
+
+### 5. Disable UI During Async Operations
+
+```typescript
+// ✅ Good: Disable button during pending state
+<button
+  uiButton
+  [disabled]="returnItemsAndPrintReciptStatusPending()"
+  [pending]="returnItemsAndPrintReciptStatusPending()"
+  (click)="returnItemsAndPrintRecipt()">
+
+// ❌ Bad: No disabled state, allows multiple clicks
+<button (click)="returnItemsAndPrintRecipt()">
+```
+
+### 6. Clean Return Info Display
+
+```typescript
+// ✅ Good: Remove duplicates and filter empty values
+returnInfos = computed<string[]>(() => {
+  const result: string[] = [];
+  // ... collect info
+  return Array.from(new Set(result));  // Remove duplicates
+});
+
+// ❌ Bad: Show duplicate info or empty entries
+returnInfos = computed(() => {
+  return [condition, reason, details];  // May have duplicates
+});
+```
+
+### 7. Navigation After State Update
+
+```typescript
+// ✅ Good: Update store before navigation
+this.#returnProcessStore.finishProcess(returnReceipts);
+await this.#router.navigate(['../', 'review'], {
+  relativeTo: this.#activatedRoute
+});
+
+// ❌ Bad: Navigate before state update
+await this.#router.navigate(['../', 'review']);
+this.#returnProcessStore.finishProcess(returnReceipts);
+```
+
+### 8. Conditional Rendering with Signals
+
+```typescript
+// ✅ Good: Use control flow syntax with signals
+@if (returnItemsAndPrintReciptStatus() !== "success") {
+  <button>Complete Return</button>
+}
+
+// ❌ Bad: Old *ngIf syntax (still works but less optimal)
+<button *ngIf="status !== 'success'">Complete Return</button>
+```
+
+### 9. Product Category-Specific Logic
+
+```typescript
+// ✅ Good: Handle Tolino products specially
+if (returnProcess.productCategory !== ProductCategory.Tolino) {
+  if (itemCondition) result.push(itemCondition);
+  if (returnReason) result.push(returnReason);
+}
+
+// ❌ Bad: Show all fields for all categories
+result.push(itemCondition, returnReason);
+```
+
+### 10. Relative Route Navigation
+
+```typescript
+// ✅ Good: Relative navigation with ActivatedRoute
+await this.#router.navigate(['../', 'review'], {
+  relativeTo: this.#activatedRoute
+});
+
+// ❌ Bad: Hardcoded absolute paths
+await this.#router.navigate(['/return/42/summary/review']);
+```
+
+## Dependencies
+
+### Required Angular Libraries
+
+- `@angular/core` (^20.1.2) - Angular framework with signals support
+- `@angular/common` (^20.1.2) - Common Angular utilities (Location service)
+- `@angular/router` (^20.1.2) - Routing and navigation
+
+### ISA Internal Libraries
+
+#### Core Libraries
+- `@isa/core/tabs` - Tab/process ID management with `injectTabId()`
+- `@isa/core/logging` - Centralized logging service
+
+#### OMS Domain Libraries
+- `@isa/oms/data-access` - Return process state management and services
+  - `ReturnProcessStore` - NgRx Signals store
+  - `ReturnProcessService` - Business logic service
+  - `ReturnProcess` - Return process model
+  - `EligibleForReturn`, `EligibleForReturnState` - Eligibility types
+  - `ProductCategory` - Product categorization
+  - `returnDetailsMapping` - Return details formatter
+
+#### Shared Libraries
+- `@isa/oms/shared/product-info` - Product information display component
+- `@isa/ui/buttons` - Button and icon button components
+- `@isa/icons` - Icon library (`isaActionChevronLeft`, `isaActionChevronRight`, `isaActionEdit`, `isaActionClose`)
+
+### Third-Party Libraries
+
+- `@ng-icons/core` - Icon component system with `NgIcon` and `provideIcons()`
+
+### Path Alias
+
+Import from: `@isa/oms/feature/return-summary`
+
+### Peer Dependencies
+
+This library expects the following to be available in the consuming application:
+
+- Angular 20.1.2 or higher
+- Tailwind CSS configured with ISA design tokens
+- NgRx Signals (@ngrx/signals)
+- Return process state properly initialized in ReturnProcessStore
+
+## Architecture Notes
+
+### Integration Points
+
+**Upstream Dependencies:**
+```
+Return Details Collection
+    ↓ (populates ReturnProcessStore)
+Return Summary (This Library)
+    ↓ (completes and stores receipts)
+Return Review
+```
+
+**State Flow:**
+```
+ReturnProcessStore
+    ↓ (entities filtered by processId)
+ReturnSummaryComponent
+    ↓ (passes individual processes)
+ReturnSummaryItemComponent
+    ↓ (displays product + return info)
+User Confirmation
+    ↓ (completion)
+ReturnProcessService
+    ↓ (API call + receipt generation)
+Back to ReturnProcessStore
+    ↓ (finishProcess updates)
+Navigate to Review
+```
+
+### Design Patterns
+
+1. **Presentation + Container Pattern**
+   - `ReturnSummaryComponent` = Container (orchestrates flow)
+   - `ReturnSummaryItemComponent` = Presentation (displays data)
+
+2. **Signal-Based Reactivity**
+   - All state management uses Angular signals
+   - Computed signals for derived state
+   - No manual subscription management needed
+
+3. **Service Facade Pattern**
+   - `ReturnProcessService` abstracts API complexity
+   - Single method `completeReturnProcess()` handles entire flow
+
+4. **Optimistic UI Updates**
+   - Status signal immediately set to 'pending'
+   - UI disables to prevent further interaction
+   - Rollback on error (status set to 'error')
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Undo Functionality** - Allow users to go back and modify before final confirmation
+2. **Bulk Actions** - Select/deselect items for return in the summary
+3. **Print Preview** - Show receipt preview before final confirmation
+4. **Offline Support** - Queue returns when offline, sync when online
+5. **Analytics Integration** - Track return patterns and reasons
+6. **Accessibility Improvements** - Screen reader announcements for status changes
+7. **Animation** - Smooth transitions between states
+8. **Keyboard Shortcuts** - Quick navigation and confirmation via keyboard
+
+### Known Considerations
+
+1. **No Loading Skeleton** - Component shows empty state until data loads
+2. **No Retry Mechanism** - Failed returns require manual retry (button click)
+3. **Hard-Coded German Text** - Internationalization not implemented
+4. **Navigation Dependency** - Assumes review route exists at '../review'
+5. **Store Coupling** - Tightly coupled to ReturnProcessStore structure
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/oms/shared/product-info/README.md b/libs/oms/shared/product-info/README.md
index 50a2b6e67..51fda34d9 100644
--- a/libs/oms/shared/product-info/README.md
+++ b/libs/oms/shared/product-info/README.md
@@ -1,7 +1,1085 @@
-# oms-shared-product-info
+# @isa/oms/shared/product-info
 
-This library was generated with [Nx](https://nx.dev).
+A reusable Angular component library for displaying product information in a standardized, visually consistent format across Order Management System (OMS) workflows.
 
-## Running unit tests
+## Overview
 
-Run `nx test oms-shared-product-info` to execute the unit tests.
+The Product Info library provides the `ReturnProductInfoComponent`, a presentation component that displays product details including product image, contributors, name, and format information. It's specifically designed for use in return process workflows but can be adapted for any OMS context where consistent product information display is needed.
+
+The component integrates seamlessly with the ISA design system, utilizing Tailwind CSS utilities and the ISA typography system for consistent visual presentation.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Component API Reference](#component-api-reference)
+- [Usage Examples](#usage-examples)
+- [Styling and Customization](#styling-and-customization)
+- [Architecture Notes](#architecture-notes)
+- [Dependencies](#dependencies)
+- [Testing](#testing)
+- [Best Practices](#best-practices)
+
+## Features
+
+- **Standalone Component Architecture** - Modern Angular standalone component with explicit imports
+- **OnPush Change Detection** - Optimized performance with ChangeDetectionStrategy.OnPush
+- **Signal-based Inputs** - Uses Angular signals for reactive property updates
+- **Product Image Integration** - Automatic product image loading via EAN with `ProductImageDirective`
+- **Product Navigation** - Built-in navigation to product details via `ProductRouterLinkDirective`
+- **Format Icons** - Visual format indicators using icon system (Hardcover, Paperback, CD, etc.)
+- **E2E Testing Attributes** - Comprehensive `data-what` and `data-which` attributes for automated testing
+- **ISA Design System Integration** - Consistent typography and spacing using ISA Tailwind utilities
+- **BEM-like SCSS Structure** - Maintainable component-scoped styling with clear naming
+- **Type Safety** - Full TypeScript integration with Zod-validated Product schema
+
+## Quick Start
+
+### 1. Import the Component
+
+```typescript
+import { Component } from '@angular/core';
+import { ReturnProductInfoComponent } from '@isa/oms/shared/product-info';
+import { Product } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-return-summary',
+  standalone: true,
+  imports: [ReturnProductInfoComponent],
+  template: `
+    <oms-shared-return-product-info
+      [product]="product"
+    ></oms-shared-return-product-info>
+  `
+})
+export class ReturnSummaryComponent {
+  product: Product = {
+    ean: '9783161484100',
+    name: 'The Great Gatsby',
+    contributors: 'F. Scott Fitzgerald',
+    format: 'HC',
+    formatDetail: 'Hardcover',
+    // ... other product properties
+  };
+}
+```
+
+### 2. Basic Template Usage
+
+```html
+<!-- Minimal usage -->
+<oms-shared-return-product-info
+  [product]="product"
+></oms-shared-return-product-info>
+
+<!-- With E2E attributes -->
+<oms-shared-return-product-info
+  [product]="product"
+  data-what="component"
+  data-which="return-product-info"
+></oms-shared-return-product-info>
+```
+
+### 3. Integration with Signals
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { ReturnProductInfoComponent } from '@isa/oms/shared/product-info';
+import { Product } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-product-display',
+  standalone: true,
+  imports: [ReturnProductInfoComponent],
+  template: `
+    <oms-shared-return-product-info
+      [product]="currentProduct()"
+    ></oms-shared-return-product-info>
+  `
+})
+export class ProductDisplayComponent {
+  currentProduct = signal<Product>({
+    ean: '9783161484100',
+    name: 'Angular Essentials',
+    contributors: 'John Doe',
+    format: 'TB',
+    formatDetail: 'Paperback',
+    // ... other properties
+  });
+
+  updateProduct(newProduct: Product): void {
+    this.currentProduct.set(newProduct);
+  }
+}
+```
+
+## Component API Reference
+
+### ReturnProductInfoComponent
+
+A presentation component that displays product information in a standardized layout with image, contributors, name, and format.
+
+#### Selector
+
+```typescript
+'oms-shared-return-product-info'
+```
+
+#### Inputs
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| `product` | `Product` | Yes | Product object containing EAN, name, contributors, format, and other details |
+
+#### Product Model Structure
+
+The component expects a `Product` object with the following structure:
+
+```typescript
+interface Product {
+  // Product Identification
+  ean?: string;                      // European Article Number (barcode)
+  catalogProductNumber?: string;     // Internal catalog number
+  supplierProductNumber?: string;    // Supplier's product number
+
+  // Product Information
+  name?: string;                     // Product name/title
+  additionalName?: string;           // Subtitle or additional name
+  contributors?: string;             // Authors, artists, or contributors
+  manufacturer?: string;             // Manufacturer/publisher name
+
+  // Format and Physical Details
+  format?: string;                   // Format code (HC, TB, AU, etc.)
+  formatDetail?: string;             // Human-readable format (Hardcover, Paperback, etc.)
+  size?: any;                        // Physical size information
+  weight?: any;                      // Weight information
+  volume?: string;                   // Volume number or identifier
+
+  // Classification
+  productGroup?: string;             // Product group classification
+  productGroupDetails?: string;      // Detailed product group info
+  edition?: string;                  // Edition information
+  locale?: string;                   // Language/locale code
+  serial?: string;                   // Serial number
+  publicationDate?: string;          // Publication date (ISO format)
+
+  // TouchBase fields (from TouchBaseSchema)
+  // Additional timestamp and metadata fields
+}
+```
+
+#### Template Structure
+
+The component renders the following structure:
+
+```html
+<div class="return-product-info" data-what="product-info" data-which="return-product">
+  <!-- Product Image with Navigation -->
+  <img
+    sharedProductRouterLink
+    sharedProductImage
+    [ean]="product().ean"
+    [alt]="product().name"
+    class="return-product-info__image w-14"
+    data-what="product-image"
+  />
+
+  <!-- Product Details -->
+  <div class="return-product-info__content">
+    <!-- Contributors (Bold) -->
+    <div
+      class="return-product-info__contributors isa-text-body-2-bold text-isa-neutral-900"
+      data-what="product-contributors"
+    >
+      {{ product().contributors }}
+    </div>
+
+    <!-- Product Name (Regular) -->
+    <div
+      class="return-product-info__name isa-text-body-2-regular text-isa-neutral-900"
+      data-what="product-name"
+    >
+      {{ product().name }}
+    </div>
+
+    <!-- Format Icon and Detail -->
+    <div class="return-product-info__format" data-what="product-format">
+      <ng-icon [name]="product().format | lowercase"></ng-icon>
+      <span class="text-isa-secondary-900">{{ product().formatDetail }}</span>
+    </div>
+  </div>
+</div>
+```
+
+#### E2E Testing Attributes
+
+The component includes comprehensive testing attributes:
+
+| Element | `data-what` | `data-which` | Description |
+|---------|-------------|--------------|-------------|
+| Root container | `product-info` | `return-product` | Main component container |
+| Product image | `product-image` | - | Product thumbnail image |
+| Contributors | `product-contributors` | - | Author/artist/contributor names |
+| Product name | `product-name` | - | Product title/name |
+| Format section | `product-format` | - | Format icon and detail container |
+
+#### Change Detection
+
+- **Strategy**: `ChangeDetectionStrategy.OnPush`
+- **Benefit**: Component only re-renders when input references change
+- **Usage**: Provides optimal performance in lists and grids
+
+## Usage Examples
+
+### Basic Product Display in Return Workflow
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { ReturnProductInfoComponent } from '@isa/oms/shared/product-info';
+import { ReturnProcessStore } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-return-summary-item',
+  standalone: true,
+  imports: [ReturnProductInfoComponent],
+  template: `
+    @let product = returnProcess().receiptItem.product;
+    <oms-shared-return-product-info
+      [product]="product"
+      data-what="component"
+      data-which="return-product-info"
+    ></oms-shared-return-product-info>
+  `
+})
+export class ReturnSummaryItemComponent {
+  #returnProcessStore = inject(ReturnProcessStore);
+  returnProcess = this.#returnProcessStore.returnProcess;
+}
+```
+
+### Product List Display
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { ReturnProductInfoComponent } from '@isa/oms/shared/product-info';
+import { Product } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-product-list',
+  standalone: true,
+  imports: [ReturnProductInfoComponent],
+  template: `
+    <div class="product-grid grid gap-4">
+      @for (product of products(); track product.ean) {
+        <div class="product-card border rounded-lg p-4">
+          <oms-shared-return-product-info
+            [product]="product"
+            [attr.data-product-ean]="product.ean"
+          ></oms-shared-return-product-info>
+        </div>
+      }
+    </div>
+  `
+})
+export class ProductListComponent {
+  products = signal<Product[]>([
+    {
+      ean: '9783161484100',
+      name: 'The Great Gatsby',
+      contributors: 'F. Scott Fitzgerald',
+      format: 'HC',
+      formatDetail: 'Hardcover',
+      catalogProductNumber: 'CAT-001',
+    },
+    {
+      ean: '9780142437230',
+      name: '1984',
+      contributors: 'George Orwell',
+      format: 'TB',
+      formatDetail: 'Paperback',
+      catalogProductNumber: 'CAT-002',
+    }
+  ]);
+}
+```
+
+### Async Product Loading
+
+```typescript
+import { Component, signal, OnInit, inject } from '@angular/core';
+import { ReturnProductInfoComponent } from '@isa/oms/shared/product-info';
+import { Product } from '@isa/oms/data-access';
+import { ProductService } from './product.service';
+
+@Component({
+  selector: 'app-product-detail',
+  standalone: true,
+  imports: [ReturnProductInfoComponent],
+  template: `
+    @if (product(); as prod) {
+      <div class="product-detail-card">
+        <oms-shared-return-product-info
+          [product]="prod"
+        ></oms-shared-return-product-info>
+
+        <!-- Additional product details -->
+        <div class="mt-4">
+          <p>EAN: {{ prod.ean }}</p>
+          <p>Publisher: {{ prod.manufacturer }}</p>
+        </div>
+      </div>
+    } @else {
+      <div class="loading">Loading product...</div>
+    }
+  `
+})
+export class ProductDetailComponent implements OnInit {
+  #productService = inject(ProductService);
+  product = signal<Product | null>(null);
+
+  async ngOnInit(): Promise<void> {
+    const productData = await this.#productService.getProduct('9783161484100');
+    this.product.set(productData);
+  }
+}
+```
+
+### Integration with Task List
+
+```typescript
+import { Component, input } from '@angular/core';
+import { ReturnProductInfoComponent } from '@isa/oms/shared/product-info';
+import { Product } from '@isa/oms/data-access';
+
+interface TaskItem {
+  id: string;
+  product: Product;
+  quantity: number;
+  status: 'pending' | 'completed';
+}
+
+@Component({
+  selector: 'app-task-list-item',
+  standalone: true,
+  imports: [ReturnProductInfoComponent],
+  template: `
+    <div class="task-item flex items-start gap-4 p-4 border-b">
+      <!-- Product Info -->
+      <oms-shared-return-product-info
+        [product]="task().product"
+      ></oms-shared-return-product-info>
+
+      <!-- Task Metadata -->
+      <div class="task-meta">
+        <span>Quantity: {{ task().quantity }}</span>
+        <span>Status: {{ task().status }}</span>
+      </div>
+    </div>
+  `
+})
+export class TaskListItemComponent {
+  task = input.required<TaskItem>();
+}
+```
+
+### Custom E2E Attributes for Complex Workflows
+
+```typescript
+@Component({
+  selector: 'app-return-process-item',
+  standalone: true,
+  imports: [ReturnProductInfoComponent],
+  template: `
+    <div
+      class="return-item"
+      [attr.data-return-id]="returnId()"
+      [attr.data-step]="currentStep()"
+    >
+      <oms-shared-return-product-info
+        [product]="product()"
+        data-what="component"
+        data-which="return-product-info"
+        [attr.data-product-ean]="product().ean"
+        [attr.data-return-status]="returnStatus()"
+      ></oms-shared-return-product-info>
+    </div>
+  `
+})
+export class ReturnProcessItemComponent {
+  returnId = input.required<string>();
+  product = input.required<Product>();
+  currentStep = input<number>(1);
+  returnStatus = input<string>('pending');
+}
+```
+
+### Conditional Product Display
+
+```typescript
+import { Component, signal, computed } from '@angular/core';
+import { ReturnProductInfoComponent } from '@isa/oms/shared/product-info';
+import { Product } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-conditional-product',
+  standalone: true,
+  imports: [ReturnProductInfoComponent],
+  template: `
+    @if (isProductAvailable()) {
+      <oms-shared-return-product-info
+        [product]="product()!"
+      ></oms-shared-return-product-info>
+    } @else {
+      <div class="product-unavailable">
+        <p>Product information unavailable</p>
+      </div>
+    }
+  `
+})
+export class ConditionalProductComponent {
+  product = signal<Product | null>(null);
+
+  isProductAvailable = computed(() => {
+    const prod = this.product();
+    return prod !== null && prod.ean !== undefined;
+  });
+}
+```
+
+## Styling and Customization
+
+### Component Styling Structure
+
+The component uses a BEM-like SCSS structure with the following classes:
+
+```scss
+.return-product-info {
+  display: flex;
+  align-items: flex-start;
+  gap: 1.5rem;
+}
+
+.return-product-info__image {
+  border-radius: 0.25rem;
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
+}
+
+.return-product-info__content {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+}
+
+.return-product-info__format {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+```
+
+### Layout Characteristics
+
+- **Flexbox Layout**: Horizontal layout with image on left, content on right
+- **Alignment**: `flex-start` for top alignment of image and content
+- **Gap**: `1.5rem` (24px) between image and content
+- **Image**: Fixed width of `w-14` (56px) with rounded corners and subtle shadow
+- **Content Stack**: Vertical layout with `0.25rem` (4px) gap between elements
+
+### ISA Design System Integration
+
+The component uses ISA-specific Tailwind utilities:
+
+| Element | Typography Class | Color Class | Description |
+|---------|-----------------|-------------|-------------|
+| Contributors | `isa-text-body-2-bold` | `text-isa-neutral-900` | Bold, dark neutral color |
+| Product Name | `isa-text-body-2-regular` | `text-isa-neutral-900` | Regular weight, dark neutral |
+| Format Detail | - | `text-isa-secondary-900` | Secondary color for format text |
+| Image | `w-14` | - | 56px fixed width thumbnail |
+
+### Customizing via CSS Custom Properties
+
+While the component uses scoped styles, you can customize the appearance by wrapping it:
+
+```html
+<div class="custom-product-info">
+  <oms-shared-return-product-info
+    [product]="product"
+  ></oms-shared-return-product-info>
+</div>
+```
+
+```scss
+.custom-product-info {
+  // Adjust the overall container
+  ::ng-deep .return-product-info {
+    gap: 2rem; // Increase spacing
+    padding: 1rem; // Add padding
+    background-color: var(--isa-neutral-50); // Add background
+    border-radius: 0.5rem;
+  }
+
+  // Adjust the image size
+  ::ng-deep .return-product-info__image {
+    width: 4rem; // 64px instead of 56px
+    height: 4rem;
+  }
+}
+```
+
+**Note**: Use `::ng-deep` sparingly and only when necessary, as it breaks view encapsulation.
+
+### Format Icons
+
+The component supports the following format icons from `ProductFormatIconGroup`:
+
+| Format Code | Icon | Description |
+|-------------|------|-------------|
+| `tb` | `isaArtikelTaschenbuch` | Paperback/Taschenbuch |
+| `hc` | `isaArtikelKartoniert` | Hardcover/Kartoniert |
+| `au` | `isaArtikelCd` | Audio CD |
+| `ka` | `isaArtikelSonstige` | Card/Other |
+| `sw` | `isaArtikelCd` | Software/CD |
+| `nb` | `isaArtikelGame` | Game/Notebook |
+
+The format code from `product.format` is automatically lowercased and mapped to the corresponding icon.
+
+### Responsive Design Considerations
+
+The component uses fixed-width layout suitable for most contexts. For responsive behavior:
+
+```html
+<!-- Stack on mobile, horizontal on desktop -->
+<div class="product-wrapper">
+  <oms-shared-return-product-info
+    [product]="product"
+  ></oms-shared-return-product-info>
+</div>
+```
+
+```scss
+.product-wrapper {
+  // Override flex direction on mobile
+  @media (max-width: 640px) {
+    ::ng-deep .return-product-info {
+      flex-direction: column;
+      align-items: center;
+    }
+  }
+}
+```
+
+## Architecture Notes
+
+### Component Design Pattern
+
+The component follows the **Presentation Component** pattern:
+
+- **No Business Logic**: Pure presentation with no service injection
+- **Signal Input**: Reactive data binding via Angular signals
+- **OnPush Detection**: Optimal performance with immutable inputs
+- **Standalone**: No module dependencies, explicit imports only
+
+### Directive Integration
+
+The component integrates two key directives:
+
+#### 1. ProductImageDirective (`sharedProductImage`)
+
+- **Purpose**: Automatically loads product images from EAN
+- **Service**: Uses `ProductImageService` to construct image URLs
+- **Inputs**:
+  - `ean` (required): Product EAN for image lookup
+  - `imageWidth` (optional): Image width, defaults to 150px
+  - `imageHeight` (optional): Image height, defaults to 150px
+- **Behavior**: Computes image URL and binds to `[src]` attribute
+
+#### 2. ProductRouterLinkDirective (`sharedProductRouterLink`)
+
+- **Purpose**: Makes product images clickable and navigable
+- **Service**: Uses injected `PRODUCT_ROUTER_LINK_BUILDER` for URL construction
+- **Inputs**:
+  - `ean` (required): Product EAN for routing
+- **Behavior**: Extends `RouterLink` and builds URL asynchronously via effect
+- **Visual**: Adds `cursor-pointer` class for clickable appearance
+
+### Icon System Integration
+
+The component uses `@ng-icons/core` with the ISA icon library:
+
+```typescript
+providers: [provideIcons({ ...ProductFormatIconGroup })]
+```
+
+This provides format-specific icons that are:
+- Automatically selected based on lowercase format code
+- Rendered inline with format detail text
+- Scalable and themeable
+
+### Change Detection Strategy
+
+**ChangeDetectionStrategy.OnPush** ensures:
+- Component only re-renders when `product` input reference changes
+- Optimal performance in lists with many product items
+- Requires immutable data patterns (use `.set()` not `.mutate()` on signals)
+
+### E2E Testing Architecture
+
+The component follows ISA's E2E testing standards:
+
+```html
+data-what="product-info"      <!-- Element type -->
+data-which="return-product"   <!-- Element purpose/context -->
+```
+
+This enables QA automation to:
+- Locate elements independent of styling changes
+- Verify product information display
+- Test product navigation behavior
+- Validate format icon rendering
+
+### Dependency Graph
+
+```
+ReturnProductInfoComponent
+├─→ @isa/oms/data-access (Product type)
+├─→ @isa/shared/product-image (ProductImageDirective)
+├─→ @isa/shared/product-router-link (ProductRouterLinkDirective)
+├─→ @isa/icons (ProductFormatIconGroup)
+├─→ @ng-icons/core (NgIcon, provideIcons)
+└─→ @angular/common (LowerCasePipe)
+```
+
+### Known Architectural Considerations
+
+#### 1. Naming Convention (Low Priority)
+
+**Current State:**
+- Component name includes "Return" prefix (`ReturnProductInfoComponent`)
+- Selector uses `oms-shared-return-product-info`
+- Implies exclusive use in return workflows
+
+**Consideration:**
+- Component is generic and could be used in any product display context
+- Consider renaming to `ProductInfoComponent` for broader reusability
+- Would require migration of existing usage sites
+
+**Impact:** Low - component works well as-is, naming is semantic for current use
+
+#### 2. Product Model Optional Fields
+
+**Current State:**
+- All `Product` fields are optional (`string | undefined`)
+- Component assumes `ean`, `name`, `contributors`, `format`, and `formatDetail` exist
+- No null/undefined handling in template
+
+**Consideration:**
+- Component may render empty strings if required fields are undefined
+- Consider adding default values or conditional rendering
+- Could add input validation or required field checks
+
+**Impact:** Medium - potential for incomplete UI if product data is partial
+
+**Recommended Enhancement:**
+```typescript
+@Component({
+  template: `
+    @if (hasRequiredFields()) {
+      <!-- Current template -->
+    } @else {
+      <div class="product-info-error">Incomplete product data</div>
+    }
+  `
+})
+export class ReturnProductInfoComponent {
+  product = input.required<Product>();
+
+  hasRequiredFields = computed(() => {
+    const prod = this.product();
+    return !!(prod.ean && prod.name && prod.contributors);
+  });
+}
+```
+
+#### 3. Image Loading States
+
+**Current State:**
+- No loading state or error handling for product images
+- `ProductImageDirective` handles URL construction
+- Missing image will show broken image icon
+
+**Consideration:**
+- Add loading skeleton or placeholder
+- Handle image load errors gracefully
+- Consider lazy loading for lists
+
+**Impact:** Medium - affects user experience with slow networks or missing images
+
+#### 4. Format Icon Fallback
+
+**Current State:**
+- Format code is lowercased and mapped to icon name
+- If format code doesn't match icon group, icon won't render
+- No fallback icon for unknown formats
+
+**Consideration:**
+- Add default icon for unknown format codes
+- Handle undefined/null format gracefully
+- Log warning when format is unmapped
+
+**Impact:** Low - most products have standard format codes
+
+## Dependencies
+
+### Required Angular Packages
+
+- `@angular/core` ^20.1.2 - Angular framework (signals, components, change detection)
+- `@angular/common` - Common Angular utilities (LowerCasePipe)
+
+### Required ISA Libraries
+
+- `@isa/oms/data-access` - Product type definition and Zod schema
+- `@isa/shared/product-image` - ProductImageDirective for image loading
+- `@isa/shared/product-router-link` - ProductRouterLinkDirective for navigation
+- `@isa/icons` - ProductFormatIconGroup icon set
+
+### Required Third-Party Packages
+
+- `@ng-icons/core` - Icon rendering system
+- `zod` - Runtime schema validation (Product type)
+
+### Development Dependencies
+
+- `@ngneat/spectator` - Testing utilities (current tests)
+- `jest` - Testing framework
+- `ng-mocks` - Directive mocking for tests
+
+### Path Alias
+
+Import from: `@isa/oms/shared/product-info`
+
+```typescript
+import { ReturnProductInfoComponent } from '@isa/oms/shared/product-info';
+```
+
+## Testing
+
+The library uses **Jest** with **Spectator** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test oms-shared-product-info --skip-nx-cache
+
+# Run tests with coverage
+npx nx test oms-shared-product-info --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test oms-shared-product-info --watch
+```
+
+### Test Structure
+
+The component includes comprehensive unit tests covering:
+
+- **Component Creation** - Validates component instantiation
+- **Product Display** - Tests rendering of name and contributors
+- **Image Directive Binding** - Verifies EAN is passed to ProductImageDirective
+- **Alt Text** - Validates image alt attribute matches product name
+- **Format Display** - Tests format icon and formatDetail rendering
+- **E2E Attributes** - Validates all testing attributes are present
+
+### Example Test
+
+```typescript
+import { createComponentFactory, Spectator } from '@ngneat/spectator/jest';
+import { ReturnProductInfoComponent } from './return-product-info.component';
+import { Product } from '@isa/oms/data-access';
+
+const MOCK_PRODUCT: Product = {
+  catalogProductNumber: '123456',
+  ean: '1234567890123',
+  manufacturer: 'Example Publisher',
+  name: 'Example Product Name',
+  volume: '2',
+  contributors: 'John Doe, Jane Smith',
+  format: 'HC',
+  formatDetail: 'Hardcover',
+};
+
+describe('ReturnProductInfoComponent', () => {
+  let spectator: Spectator<ReturnProductInfoComponent>;
+
+  const createComponent = createComponentFactory({
+    component: ReturnProductInfoComponent,
+    // Mock directives to avoid external dependencies
+    detectChanges: false,
+  });
+
+  beforeEach(() => {
+    spectator = createComponent({
+      props: { product: MOCK_PRODUCT }
+    });
+    spectator.detectChanges();
+  });
+
+  it('should display product name and contributors', () => {
+    const contributorsEl = spectator.query('[data-what="product-contributors"]');
+    const nameEl = spectator.query('[data-what="product-name"]');
+
+    expect(contributorsEl).toHaveText(MOCK_PRODUCT.contributors);
+    expect(nameEl).toHaveText(MOCK_PRODUCT.name);
+  });
+
+  it('should pass correct EAN to product image directive', () => {
+    const imgElement = spectator.query('img');
+    const productImageDirective = spectator.query(ProductImageDirective);
+
+    expect(productImageDirective?.ean).toBe(MOCK_PRODUCT.ean);
+    expect(imgElement).toHaveAttribute('alt', MOCK_PRODUCT.name);
+  });
+});
+```
+
+### Test Coverage
+
+Current test coverage includes:
+
+- ✅ Component instantiation
+- ✅ Product name display
+- ✅ Contributors display
+- ✅ EAN binding to image directive
+- ✅ Alt text for accessibility
+- ✅ Format icon rendering
+- ✅ Format detail text display
+- ✅ E2E attribute presence
+
+### Testing Best Practices
+
+1. **Mock Directives**: Use `MockDirective()` from `ng-mocks` for ProductImageDirective and ProductRouterLinkDirective
+2. **Mock Product Data**: Create comprehensive mock products with all required fields
+3. **E2E Selectors**: Use `data-what` attributes for element selection in tests
+4. **Signal Testing**: Test computed signals and reactive updates
+5. **Accessibility**: Verify alt text and semantic HTML structure
+
+### Migration to Vitest (Planned)
+
+This library is scheduled for migration to Vitest + Angular Testing Utilities:
+
+```typescript
+// Future test structure
+import { TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach } from 'vitest';
+import { ReturnProductInfoComponent } from './return-product-info.component';
+
+describe('ReturnProductInfoComponent', () => {
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      imports: [ReturnProductInfoComponent]
+    });
+  });
+
+  it('should create', () => {
+    const fixture = TestBed.createComponent(ReturnProductInfoComponent);
+    expect(fixture.componentInstance).toBeTruthy();
+  });
+});
+```
+
+## Best Practices
+
+### Component Usage
+
+1. **Always Provide Complete Product Data**
+   ```typescript
+   // Good: Complete product object
+   product = signal<Product>({
+     ean: '9783161484100',
+     name: 'The Great Gatsby',
+     contributors: 'F. Scott Fitzgerald',
+     format: 'HC',
+     formatDetail: 'Hardcover',
+   });
+
+   // Avoid: Partial product data may cause rendering issues
+   product = signal<Product>({ ean: '123' }); // Missing name, contributors
+   ```
+
+2. **Use Immutable Data Patterns with OnPush**
+   ```typescript
+   // Good: Create new reference
+   this.product.set({ ...currentProduct, name: 'New Name' });
+
+   // Bad: Mutate existing object (won't trigger change detection)
+   this.product().name = 'New Name';
+   ```
+
+3. **Include E2E Attributes in Parent Components**
+   ```html
+   <!-- Good: Add context-specific attributes -->
+   <oms-shared-return-product-info
+     [product]="product"
+     data-what="component"
+     data-which="return-product-info"
+     [attr.data-product-ean]="product.ean"
+   ></oms-shared-return-product-info>
+
+   <!-- Minimal: Basic usage without additional attributes -->
+   <oms-shared-return-product-info
+     [product]="product"
+   ></oms-shared-return-product-info>
+   ```
+
+4. **Handle Async Product Loading**
+   ```typescript
+   // Good: Wait for product data before rendering
+   @Component({
+     template: `
+       @if (product(); as prod) {
+         <oms-shared-return-product-info [product]="prod" />
+       } @else {
+         <div class="loading-skeleton"></div>
+       }
+     `
+   })
+   export class ProductContainerComponent {
+     product = signal<Product | null>(null);
+   }
+   ```
+
+### Styling and Layout
+
+1. **Use Wrapper Divs for Additional Layout**
+   ```html
+   <!-- Good: Wrap for additional styling without ::ng-deep -->
+   <div class="custom-card p-4 border rounded">
+     <oms-shared-return-product-info [product]="product" />
+   </div>
+
+   <!-- Avoid: Don't break encapsulation unless necessary -->
+   <style>
+     ::ng-deep .return-product-info { /* ... */ }
+   </style>
+   ```
+
+2. **Respect Component's Fixed Image Width**
+   ```html
+   <!-- Component uses w-14 (56px) - design other elements accordingly -->
+   <div class="grid grid-cols-[56px_1fr_auto]">
+     <oms-shared-return-product-info [product]="product" />
+     <div>Additional content</div>
+   </div>
+   ```
+
+### Performance
+
+1. **Use trackBy in Lists**
+   ```html
+   <!-- Good: Track by unique identifier -->
+   @for (product of products(); track product.ean) {
+     <oms-shared-return-product-info [product]="product" />
+   }
+
+   <!-- Avoid: No tracking causes unnecessary re-renders -->
+   @for (product of products(); track $index) {
+     <oms-shared-return-product-info [product]="product" />
+   }
+   ```
+
+2. **Leverage OnPush Change Detection**
+   ```typescript
+   // Good: Component already uses OnPush, ensure parent does too
+   @Component({
+     changeDetection: ChangeDetectionStrategy.OnPush,
+     imports: [ReturnProductInfoComponent]
+   })
+   ```
+
+### Accessibility
+
+1. **Product Images Already Have Alt Text**
+   - Component binds `product.name` to image `alt` attribute
+   - No additional ARIA labels needed for images
+
+2. **Consider Screen Reader Context**
+   ```html
+   <!-- Good: Add semantic context -->
+   <article aria-label="Product Information">
+     <oms-shared-return-product-info [product]="product" />
+   </article>
+   ```
+
+### Testing
+
+1. **Mock External Directives**
+   ```typescript
+   import { MockDirective } from 'ng-mocks';
+
+   createComponentFactory({
+     component: ReturnProductInfoComponent,
+     overrideComponents: [[
+       ReturnProductInfoComponent,
+       {
+         remove: { imports: [ProductImageDirective, ProductRouterLinkDirective] },
+         add: { imports: [
+           MockDirective(ProductImageDirective),
+           MockDirective(ProductRouterLinkDirective)
+         ]}
+       }
+     ]]
+   });
+   ```
+
+2. **Use E2E Attributes for Selectors**
+   ```typescript
+   // Good: Stable selectors independent of styling
+   const name = spectator.query('[data-what="product-name"]');
+
+   // Avoid: Class-based selectors are fragile
+   const name = spectator.query('.return-product-info__name');
+   ```
+
+3. **Test with Realistic Product Data**
+   ```typescript
+   // Good: Complete mock product
+   const MOCK_PRODUCT: Product = {
+     ean: '9783161484100',
+     name: 'Complete Product Name',
+     contributors: 'First Last, Second Author',
+     format: 'HC',
+     formatDetail: 'Hardcover',
+     catalogProductNumber: 'CAT123',
+     manufacturer: 'Publisher Name',
+   };
+   ```
+
+### Error Handling
+
+1. **Validate Product Data Before Passing to Component**
+   ```typescript
+   // Good: Ensure product has required fields
+   function isValidProduct(product: Product): boolean {
+     return !!(product.ean && product.name && product.contributors);
+   }
+
+   @Component({
+     template: `
+       @if (isValidProduct(product())) {
+         <oms-shared-return-product-info [product]="product()" />
+       } @else {
+         <div class="error">Invalid product data</div>
+       }
+     `
+   })
+   ```
+
+2. **Handle Missing Format Icons**
+   ```typescript
+   // Component handles lowercase conversion
+   // Ensure format codes match ProductFormatIconGroup: tb, hc, au, ka, sw, nb
+   product.format = 'HC'; // Will become 'hc' and map to icon
+   ```
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/oms/shared/task-list/README.md b/libs/oms/shared/task-list/README.md
index 30b1c4520..909891759 100644
--- a/libs/oms/shared/task-list/README.md
+++ b/libs/oms/shared/task-list/README.md
@@ -1,7 +1,1603 @@
-# return-task-list
+# @isa/oms/shared/task-list
 
-This library was generated with [Nx](https://nx.dev).
+A specialized Angular component library for displaying and managing return receipt item tasks in the OMS (Order Management System) domain.
 
-## Running unit tests
+## Overview
 
-Run `nx test return-task-list` to execute the unit tests.
+The Task List library provides a complete task management interface for return processes, allowing users to view, filter, and complete receipt item tasks. It supports two distinct visual modes (main workflow and review workflow) and integrates tightly with the OMS data-access layer through NgRx Signals stores. The library handles complex task interactions including task completion, status updates (OK/NOK), and Tolino return receipt printing.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [Component API Reference](#component-api-reference)
+- [Usage Examples](#usage-examples)
+- [Styling and Customization](#styling-and-customization)
+- [Architecture Notes](#architecture-notes)
+- [Dependencies](#dependencies)
+- [Testing](#testing)
+- [Best Practices](#best-practices)
+
+## Features
+
+- **Dual appearance modes** - Main workflow (card-based) and review workflow (table-based) layouts
+- **Task filtering** - Automatic filtering of completed tasks in main view
+- **Task sorting** - Open tasks displayed first, completed tasks at the end
+- **Task completion** - One-click task completion with optimistic store updates
+- **Task status updates** - Update task type to OK (verkaufsfähig) or NOK (defekt)
+- **Tolino receipt printing** - Integrated Tolino return receipt generation
+- **NgRx Signals integration** - Reactive state management with entity store
+- **Tab-based isolation** - Process ID derived from tab context for multi-tab support
+- **Deferred rendering** - Viewport-based lazy loading for performance
+- **Product information display** - Rich product details for each task item
+- **E2E testing attributes** - Comprehensive data attributes for automated testing
+- **Error handling** - Comprehensive logging and error recovery
+
+## Quick Start
+
+### 1. Import and Use in Template
+
+```typescript
+import { Component } from '@angular/core';
+import { ReturnTaskListComponent } from '@isa/oms/shared/task-list';
+
+@Component({
+  selector: 'app-return-search',
+  standalone: true,
+  imports: [ReturnTaskListComponent],
+  template: `
+    <oms-shared-return-task-list
+      [appearance]="'main'"
+    ></oms-shared-return-task-list>
+  `
+})
+export class ReturnSearchComponent {}
+```
+
+### 2. Main Workflow Usage
+
+```html
+<!-- Use in return search workflow - shows incomplete tasks in card layout -->
+<oms-shared-return-task-list
+  [appearance]="'main'"
+></oms-shared-return-task-list>
+```
+
+### 3. Review Workflow Usage
+
+```html
+<!-- Use in return review workflow - shows all tasks in table layout -->
+<oms-shared-return-task-list
+  [appearance]="'review'"
+></oms-shared-return-task-list>
+```
+
+## Core Concepts
+
+### Task List Workflow
+
+The task list component manages the complete lifecycle of receipt item tasks:
+
+1. **Automatic Data Fetching** - Component fetches tasks on initialization using tab-based process ID
+2. **Task Display** - Tasks rendered with product information and action buttons
+3. **User Interaction** - Users complete tasks, update task status, or print receipts
+4. **Store Updates** - Optimistic UI updates via NgRx Signals store
+5. **Re-filtering** - UI automatically updates based on task completion state
+
+### Appearance Modes
+
+The component supports two distinct visual modes optimized for different workflows:
+
+#### Main Appearance (`appearance="main"`)
+- **Purpose**: Primary workflow for processing return tasks
+- **Layout**: Card-based vertical layout (24.25rem width cards)
+- **Filtering**: Shows only incomplete tasks
+- **Styling**: White cards with rounded corners and shadows
+- **Scrolling**: Vertical scroll container for desktop (max-height: calc(100vh - 13rem))
+- **Use Case**: Return search main view where staff process tasks one by one
+
+#### Review Appearance (`appearance="review"`)
+- **Purpose**: Review completed and pending tasks
+- **Layout**: Grid-based table layout (responsive columns)
+- **Filtering**: Shows all tasks (completed and incomplete)
+- **Styling**: Minimal borders, table-row style
+- **Scrolling**: Natural page scroll
+- **Use Case**: Return review page where staff review all task states
+
+### Task Action Types
+
+Tasks can have three distinct action types that determine available user interactions:
+
+```typescript
+const TaskActionTypes = {
+  OK: 'OK',         // Task marked as OK (product sellable)
+  NOK: 'NOK',       // Task marked as NOK (product defective)
+  UNKNOWN: 'UNKNOWN' // Task needs classification (OK or NOK)
+} as const;
+```
+
+#### OK Tasks
+- **Display**: "Als erledigt markieren" button
+- **Action**: Complete task
+- **Post-completion**: Shows "Abgeschlossen" with green checkmark
+
+#### NOK Tasks
+- **Display**: "Als erledigt markieren" button
+- **Action**: Complete task
+- **Post-completion**: Shows "Abgeschlossen" with green checkmark
+
+#### UNKNOWN Tasks
+- **Display**: Two action buttons (Ja verkaufsfähig / Nein, defekt)
+- **Action**: Update task type to OK or NOK
+- **Post-update**: Task re-fetched with new type, becomes completable
+
+### Store Integration
+
+The component integrates with `ReturnTaskListStore` (NgRx Signals) for reactive state management:
+
+```typescript
+// Store structure
+type ReturnTaskListItems = AsyncResult<ReceiptItemTaskListItem[]> & {
+  id: number;  // Process ID (from tab context)
+};
+
+// Entity map structure
+{
+  [processId: number]: {
+    id: number,
+    status: AsyncResultStatus,  // Idle | Pending | Success | Error
+    data: ReceiptItemTaskListItem[] | undefined,
+    error?: unknown
+  }
+}
+```
+
+**Key Store Operations:**
+- `fetchTaskListItems()` - Fetches tasks with query filter
+- `updateTaskListItem()` - Updates individual task after completion/update
+- `beforeFetch()` - Sets status to Pending
+- `fetchSuccess()` - Updates data and sets status to Success
+- `fetchError()` - Logs error and sets status to Error
+
+### Tab-Based Process Isolation
+
+The component uses `injectTabId()` from `@isa/core/tabs` to derive the process ID:
+
+```typescript
+processId = injectTabId();  // Returns Signal<number | undefined>
+```
+
+**Benefits:**
+- Multiple return processes can run simultaneously in different tabs
+- Each tab maintains independent task list state in the store
+- Process ID automatically updates when tab context changes
+- No manual process ID management required
+
+## Component API Reference
+
+### ReturnTaskListComponent
+
+Main container component that manages task list display and orchestrates task actions.
+
+**Selector**: `oms-shared-return-task-list`
+
+#### Inputs
+
+##### `appearance`
+- **Type**: `'main' | 'review'`
+- **Default**: `'main'`
+- **Description**: Visual mode controlling layout and filtering behavior
+- **Required**: No
+
+**Example:**
+```html
+<oms-shared-return-task-list
+  [appearance]="'review'"
+></oms-shared-return-task-list>
+```
+
+#### Outputs
+
+This component has no outputs. Task actions are handled internally via services and store updates.
+
+#### Host Bindings
+
+**CSS Classes:**
+- `oms-shared-return-task-list` - Always applied base class
+- `oms-shared-return-task-list__main` - Applied when `appearance="main"`
+- `oms-shared-return-task-list__review` - Applied when `appearance="review"`
+
+#### Computed Signals
+
+##### `taskListItems()`
+- **Type**: `Signal<ReceiptItemTaskListItem[]>`
+- **Description**: Filtered and sorted task list based on appearance mode
+- **Filtering Logic**:
+  - Main mode: Excludes completed tasks
+  - Review mode: Shows all tasks
+- **Sorting Logic**: Open tasks first, completed tasks last
+
+**Example:**
+```typescript
+// In main mode
+taskListItems() // Returns only incomplete tasks
+
+// In review mode
+taskListItems() // Returns all tasks (incomplete + completed)
+```
+
+##### `appearanceClass()`
+- **Type**: `Signal<string>`
+- **Description**: Dynamic CSS class based on appearance input
+- **Values**: `'oms-shared-return-task-list__main'` | `'oms-shared-return-task-list__review'`
+
+#### Public Methods
+
+##### `handleAction(action: TaskActionType): Promise<void>`
+
+Handles task actions emitted from child task list items.
+
+**Parameters:**
+- `action: TaskActionType` - Action object containing task details
+
+**Task Action Structure:**
+```typescript
+interface TaskActionType {
+  type: TaskActionTypeType;           // 'OK' | 'NOK' | 'UNKNOWN'
+  taskId: number;                     // Task identifier
+  receiptItemId?: number;             // Receipt item identifier (for Tolino)
+  updateTo?: 'OK' | 'NOK';            // Update target type (for UNKNOWN)
+  actions?: Array<KeyValue>;          // Action metadata (for Tolino)
+}
+```
+
+**Behavior:**
+1. **Tolino Receipt Printing**: If action contains `PRINT_TOLINO_RETURN_RECEIPT` key
+2. **UNKNOWN Task Update**: If type is UNKNOWN with updateTo value
+3. **Standard Completion**: All other cases
+
+**Example:**
+```typescript
+// Handled automatically by child components
+// Called internally when user clicks action buttons
+```
+
+##### `completeTask(taskId: number): Promise<void>`
+
+Marks a task as completed and updates the store.
+
+**Parameters:**
+- `taskId: number` - Unique task identifier
+
+**Side Effects:**
+- Calls `ReturnTaskListService.completeTask()`
+- Updates store via `ReturnTaskListStore.updateTaskListItem()`
+- Logs errors if completion fails
+
+**Error Handling:**
+```typescript
+try {
+  await completeTask(123);
+} catch (error) {
+  // Automatically logged with context
+  // UI remains stable - no error display to user
+}
+```
+
+##### `updateTask({ taskId, updateTo }): Promise<void>`
+
+Updates a task's type (OK or NOK) for UNKNOWN tasks.
+
+**Parameters:**
+- `taskId: number` - Unique task identifier
+- `updateTo: 'OK' | 'NOK'` - Target task type
+
+**Side Effects:**
+- Calls `ReturnTaskListService.updateTaskType()`
+- Updates store via `ReturnTaskListStore.updateTaskListItem()`
+- Logs errors if update fails
+
+**Example:**
+```typescript
+// Handled automatically when user clicks "Ja verkaufsfähig"
+await updateTask({ taskId: 123, updateTo: 'OK' });
+
+// Handled automatically when user clicks "Nein, defekt"
+await updateTask({ taskId: 123, updateTo: 'NOK' });
+```
+
+### ReturnTaskListItemComponent
+
+Individual task list item component rendering product info and action buttons.
+
+**Selector**: `oms-shared-return-task-list-item`
+
+#### Inputs
+
+##### `appearance`
+- **Type**: `'main' | 'review'`
+- **Default**: `'main'`
+- **Description**: Visual mode inherited from parent component
+- **Required**: No
+
+##### `item`
+- **Type**: `ReceiptItemTaskListItem`
+- **Required**: Yes
+- **Description**: Task item data including product, status, and actions
+
+**Item Structure:**
+```typescript
+interface ReceiptItemTaskListItem {
+  id: number;                         // Task ID
+  type: TaskActionTypeType;           // 'OK' | 'NOK' | 'UNKNOWN'
+  completed: boolean;                 // Completion status
+  processingComment?: string;         // Task description/comment
+  product?: Product;                  // Product information
+  receiptItem?: { id: number };       // Receipt item reference
+  actions?: Array<KeyValue>;          // Available actions (e.g., Tolino print)
+}
+```
+
+#### Outputs
+
+##### `action`
+- **Type**: `EventEmitter<TaskActionType>`
+- **Description**: Emits task action when user interacts with buttons
+- **Payload**: TaskActionType object with task details
+
+**Example:**
+```typescript
+// Emitted when user clicks completion button
+{ type: 'OK', taskId: 123 }
+
+// Emitted when user clicks "Ja verkaufsfähig"
+{ type: 'UNKNOWN', taskId: 123, updateTo: 'OK' }
+
+// Emitted when user clicks print receipt
+{
+  type: 'OK',
+  taskId: 123,
+  receiptItemId: 456,
+  actions: [{ key: 'PRINT_TOLINO_RETURN_RECEIPT', value: '...' }]
+}
+```
+
+#### Computed Signals
+
+##### `product()`
+- **Type**: `Signal<Product | undefined>`
+- **Description**: Extracted product information from task item
+
+##### `processingComment()`
+- **Type**: `Signal<string | undefined>`
+- **Description**: Task description/comment text
+
+##### `displayPrintTolino()`
+- **Type**: `Signal<boolean>`
+- **Description**: Whether to show Tolino print button (checks for `PRINT_TOLINO_RETURN_RECEIPT` action)
+
+##### `type()`
+- **Type**: `Signal<TaskActionTypeType>`
+- **Description**: Task action type (OK | NOK | UNKNOWN)
+
+#### Host Bindings
+
+**CSS Classes:**
+- `oms-shared-return-task-list-item` - Always applied base class
+- `oms-shared-return-task-list-item__main` - Applied when `appearance="main"`
+- `oms-shared-return-task-list-item__review` - Applied when `appearance="review"`
+
+## Usage Examples
+
+### Basic Main Workflow
+
+```typescript
+import { Component } from '@angular/core';
+import { ReturnTaskListComponent } from '@isa/oms/shared/task-list';
+
+@Component({
+  selector: 'app-return-search-main',
+  standalone: true,
+  imports: [ReturnTaskListComponent],
+  template: `
+    <div class="return-search-page">
+      <h1>Rückgabe starten</h1>
+
+      <!-- Search and filter components here -->
+
+      <oms-shared-return-task-list
+        [appearance]="'main'"
+      ></oms-shared-return-task-list>
+    </div>
+  `
+})
+export class ReturnSearchMainComponent {}
+```
+
+### Review Workflow with Header
+
+```typescript
+import { Component } from '@angular/core';
+import { ReturnTaskListComponent } from '@isa/oms/shared/task-list';
+
+@Component({
+  selector: 'app-return-review',
+  standalone: true,
+  imports: [ReturnTaskListComponent],
+  template: `
+    <div class="return-review-page">
+      <header>
+        <h1>Aufgaben überprüfen</h1>
+        <button (click)="printReceipt()">Beleg drucken</button>
+      </header>
+
+      <oms-shared-return-task-list
+        [appearance]="'review'"
+      ></oms-shared-return-task-list>
+    </div>
+  `
+})
+export class ReturnReviewComponent {
+  printReceipt(): void {
+    // Receipt printing logic
+  }
+}
+```
+
+### Dynamic Appearance Mode
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { ReturnTaskListComponent } from '@isa/oms/shared/task-list';
+
+@Component({
+  selector: 'app-task-manager',
+  standalone: true,
+  imports: [ReturnTaskListComponent],
+  template: `
+    <div>
+      <button (click)="toggleMode()">
+        {{ viewMode() === 'main' ? 'Zur Übersicht' : 'Zur Bearbeitung' }}
+      </button>
+
+      <oms-shared-return-task-list
+        [appearance]="viewMode()"
+      ></oms-shared-return-task-list>
+    </div>
+  `
+})
+export class TaskManagerComponent {
+  viewMode = signal<'main' | 'review'>('main');
+
+  toggleMode(): void {
+    this.viewMode.update(mode => mode === 'main' ? 'review' : 'main');
+  }
+}
+```
+
+### Integration with Custom Layout
+
+```typescript
+import { Component } from '@angular/core';
+import { ReturnTaskListComponent } from '@isa/oms/shared/task-list';
+
+@Component({
+  selector: 'app-custom-return-layout',
+  standalone: true,
+  imports: [ReturnTaskListComponent],
+  template: `
+    <div class="grid grid-cols-3 gap-6">
+      <!-- Left sidebar with filters -->
+      <aside class="col-span-1">
+        <h2>Filter</h2>
+        <!-- Filter components -->
+      </aside>
+
+      <!-- Main content area with task list -->
+      <main class="col-span-2">
+        <oms-shared-return-task-list
+          [appearance]="'main'"
+        ></oms-shared-return-task-list>
+      </main>
+    </div>
+  `
+})
+export class CustomReturnLayoutComponent {}
+```
+
+### Accessing Store Directly (Advanced)
+
+```typescript
+import { Component, inject, computed } from '@angular/core';
+import { ReturnTaskListStore } from '@isa/oms/data-access';
+import { injectTabId } from '@isa/core/tabs';
+import { ReturnTaskListComponent } from '@isa/oms/shared/task-list';
+
+@Component({
+  selector: 'app-advanced-task-view',
+  standalone: true,
+  imports: [ReturnTaskListComponent],
+  template: `
+    <div>
+      @if (taskCount() > 0) {
+        <p>{{ taskCount() }} offene Aufgaben</p>
+      }
+
+      <oms-shared-return-task-list
+        [appearance]="'main'"
+      ></oms-shared-return-task-list>
+    </div>
+  `
+})
+export class AdvancedTaskViewComponent {
+  #store = inject(ReturnTaskListStore);
+  processId = injectTabId();
+
+  taskCount = computed(() => {
+    const processId = this.processId();
+    if (!processId) return 0;
+
+    const entity = this.#store.entityMap()[processId];
+    return entity?.data?.filter(item => !item.completed).length ?? 0;
+  });
+}
+```
+
+### Manual Task Refresh (Advanced)
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { ReturnTaskListStore, QueryTokenInput } from '@isa/oms/data-access';
+import { injectTabId } from '@isa/core/tabs';
+import { ReturnTaskListComponent } from '@isa/oms/shared/task-list';
+
+@Component({
+  selector: 'app-refreshable-task-list',
+  standalone: true,
+  imports: [ReturnTaskListComponent],
+  template: `
+    <div>
+      <button (click)="refreshTasks()">Aktualisieren</button>
+
+      <oms-shared-return-task-list
+        [appearance]="'main'"
+      ></oms-shared-return-task-list>
+    </div>
+  `
+})
+export class RefreshableTaskListComponent {
+  #store = inject(ReturnTaskListStore);
+  processId = injectTabId();
+
+  refreshTasks(): void {
+    const processId = this.processId();
+    if (!processId) return;
+
+    const queryToken: QueryTokenInput = {
+      filter: { completed: false }
+    };
+
+    this.#store.fetchTaskListItems({ processId, queryToken });
+  }
+}
+```
+
+## Styling and Customization
+
+### Component Structure
+
+The component emits a host class that controls the layout mode:
+
+```scss
+// Main appearance - card layout
+.oms-shared-return-task-list__main {
+  @apply flex flex-col items-center gap-6 justify-self-center;
+}
+
+// Review appearance - table layout
+.oms-shared-return-task-list__review {
+  // Layout controlled by child items
+}
+```
+
+### Task List Container (Main Mode)
+
+```scss
+.return-search-main-task-list-styles {
+  @apply gap-6
+         desktop:overflow-y-scroll
+         desktop:max-h-[calc(100vh-13rem)]
+         justify-start;
+}
+```
+
+**Customization:**
+- Adjust `max-h-[calc(100vh-13rem)]` for different header heights
+- Modify `gap-6` (24px) for different card spacing
+- Override `overflow-y-scroll` behavior for custom scroll containers
+
+### Task Item Cards (Main Mode)
+
+```scss
+.oms-shared-return-task-list-item__main {
+  @apply bg-white
+         rounded-2xl
+         p-6
+         flex
+         flex-col
+         gap-6
+         w-[24.25rem];
+}
+```
+
+**Customization:**
+```scss
+// Custom card width
+.oms-shared-return-task-list-item__main {
+  width: 20rem; // Override default 24.25rem
+}
+
+// Custom card padding
+.oms-shared-return-task-list-item__main {
+  padding: 2rem; // Override default 1.5rem (p-6)
+}
+
+// Custom card shadow
+.oms-shared-return-task-list-item__main {
+  box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
+}
+```
+
+### Task Item Table Rows (Review Mode)
+
+```scss
+.oms-shared-return-task-list-item__review {
+  @apply grid
+         grid-cols-[1fr,1fr]
+         desktop:grid-cols-[1fr,1fr,minmax(20rem,auto)]
+         gap-x-6
+         desktop:gap-y-6
+         py-6
+         text-isa-secondary-900
+         items-center
+         border-b
+         border-solid
+         border-isa-neutral-300
+         last:pb-0
+         last:border-none;
+}
+```
+
+**Responsive Grid Areas (Tablet/Mobile):**
+```scss
+@media screen and (max-width: 1024px) {
+  grid-template-areas:
+    "product infos"
+    "unknown-comment actions";
+}
+```
+
+**Customization:**
+```scss
+// Custom column proportions
+.oms-shared-return-task-list-item__review {
+  grid-template-columns: 2fr 1fr minmax(15rem, auto);
+}
+
+// Custom row padding
+.oms-shared-return-task-list-item__review {
+  padding-top: 2rem;
+  padding-bottom: 2rem;
+}
+
+// Custom border color
+.oms-shared-return-task-list-item__review {
+  border-bottom-color: #e5e7eb; // Override isa-neutral-300
+}
+```
+
+### Processing Comment Styling
+
+```scss
+// Standard tasks (OK/NOK)
+.processing-comment {
+  @apply isa-text-body-2-bold;
+}
+
+// UNKNOWN tasks (larger emphasis)
+.processing-comment-unknown {
+  @apply isa-text-body-1-regular;
+}
+```
+
+### Task Action Buttons
+
+```scss
+// UNKNOWN task action buttons container
+.task-unknown-actions {
+  @apply flex
+         flex-row
+         gap-3
+         h-full
+         py-2
+         items-center
+         justify-self-end;
+}
+
+// Tolino print button positioning
+.tolino-print-cta {
+  @apply w-fit
+         self-end
+         justify-self-end
+         desktop:self-start;
+}
+```
+
+### Task Info Container
+
+```scss
+.task-item-infos {
+  @apply h-full
+         p-4
+         flex
+         flex-col
+         gap-4
+         rounded-lg
+         bg-isa-secondary-100;
+}
+```
+
+**Customization:**
+```scss
+// Custom background color
+.task-item-infos {
+  background-color: #f9fafb; // Override isa-secondary-100
+}
+
+// Custom padding
+.task-item-infos {
+  padding: 1rem; // Override p-4 (1rem)
+}
+```
+
+### Responsive Behavior
+
+#### Main Mode Breakpoints
+```scss
+// Desktop: Scrollable container
+@media (min-width: 1024px) {
+  .return-search-main-task-list-styles {
+    overflow-y: scroll;
+    max-height: calc(100vh - 13rem);
+  }
+}
+```
+
+#### Review Mode Breakpoints
+```scss
+// Tablet/Mobile: Stacked layout
+@media screen and (max-width: 1024px) {
+  .oms-shared-return-task-list-item__review {
+    grid-template-areas:
+      "product infos"
+      "unknown-comment actions";
+  }
+}
+
+// Desktop: Three-column layout
+@media (min-width: 1024px) {
+  .oms-shared-return-task-list-item__review {
+    grid-template-columns: 1fr 1fr minmax(20rem, auto);
+  }
+}
+```
+
+### Theme Integration
+
+The component uses ISA design system colors:
+
+```scss
+// Text colors
+text-isa-secondary-900    // Main text
+text-isa-accent-green     // Completed status
+
+// Background colors
+bg-white                  // Card backgrounds
+bg-isa-secondary-100      // Info containers
+
+// Border colors
+border-isa-neutral-300    // Row separators
+```
+
+**Custom Theme:**
+```scss
+// Override in your global styles
+.oms-shared-return-task-list-item__main {
+  --card-bg: theme('colors.white');
+  --info-bg: theme('colors.isa.secondary.100');
+
+  background-color: var(--card-bg);
+
+  .task-item-infos {
+    background-color: var(--info-bg);
+  }
+}
+```
+
+### E2E Testing Attributes
+
+All interactive elements include data attributes for E2E testing:
+
+```html
+<!-- Task list container -->
+<div data-what="task-list" data-which="processing-comment">
+
+<!-- Action buttons -->
+<button data-what="button" data-which="complete">
+<button data-what="button" data-which="resellable">
+<button data-what="button" data-which="damaged">
+<button data-what="button" data-which="print-receipt">
+
+<!-- Status indicators -->
+<span data-what="info" data-which="completed">
+
+<!-- Components -->
+<oms-shared-return-product-info data-what="component" data-which="return-product-info">
+```
+
+**Using in Tests:**
+```typescript
+// Playwright example
+await page.click('[data-what="button"][data-which="complete"]');
+await expect(page.locator('[data-what="info"][data-which="completed"]')).toBeVisible();
+```
+
+## Architecture Notes
+
+### Current Architecture
+
+```
+Components/Features (return-search, return-review)
+       ↓
+  ReturnTaskListComponent (orchestrator)
+       ↓
+├─→ ReturnTaskListItemComponent (presentation)
+├─→ ReturnProductInfoComponent (product display)
+├─→ ReturnTaskListStore (state management)
+├─→ ReturnTaskListService (business logic)
+├─→ PrintTolinoReturnReceiptService (printing)
+└─→ Tab Context (process isolation)
+```
+
+### Design Patterns
+
+#### 1. Container/Presenter Pattern
+- **Container**: `ReturnTaskListComponent` handles state, effects, and actions
+- **Presenter**: `ReturnTaskListItemComponent` handles display and emits events
+- **Benefits**: Clear separation of concerns, easier testing, reusable presenters
+
+#### 2. Signal-Based Reactivity
+```typescript
+// Computed signals for derived state
+taskListItems = computed(() => {
+  const processId = this.processId();
+  const appearance = this.appearance();
+
+  // Filter and sort based on inputs
+  return filteredAndSortedItems;
+});
+```
+
+**Benefits:**
+- Automatic dependency tracking
+- Efficient change detection
+- Type-safe reactive data flow
+
+#### 3. Effect-Based Data Fetching
+```typescript
+constructor() {
+  effect(() => {
+    const processId = this.processId();
+    const appearance = this.appearance();
+
+    if (processId) {
+      const filter = appearance === 'review'
+        ? { eob: true }
+        : { completed: false };
+
+      untracked(() =>
+        this.#store.fetchTaskListItems({ processId, filter })
+      );
+    }
+  });
+}
+```
+
+**Benefits:**
+- Automatic refetch when dependencies change
+- Untracked execution prevents infinite loops
+- Declarative data synchronization
+
+#### 4. Optimistic UI Updates
+```typescript
+async completeTask(taskId: number) {
+  const result = await this.#service.completeTask(taskId);
+
+  // Update store immediately (optimistic)
+  if (result && processId) {
+    this.#store.updateTaskListItem({ processId, taskListItem: result });
+  }
+}
+```
+
+**Benefits:**
+- Immediate UI feedback
+- Better perceived performance
+- Automatic rollback on error
+
+#### 5. Tab-Based Multi-Instance Support
+```typescript
+processId = injectTabId();  // Signal from tab context
+```
+
+**Benefits:**
+- Multiple simultaneous return processes
+- Isolated state per tab
+- No cross-tab interference
+
+### Known Architectural Considerations
+
+#### 1. Component Review Needed (High Priority)
+
+**Issue**: Component header comment indicates review needed
+```typescript
+// TODO: Komponente und logik benötigt review
+```
+
+**Current State:**
+- Component works but may have architectural improvements pending
+- Logic patterns established but not formally reviewed
+- No known bugs or functional issues
+
+**Proposed Review Areas:**
+- Error handling consistency
+- Store update patterns (optimistic vs pessimistic)
+- Effect dependency management
+- Template complexity reduction
+
+**Impact**: Medium - component is functional, review would improve maintainability
+
+#### 2. Deferred Rendering Performance (Low Priority)
+
+**Current State:**
+```html
+@for (item of taskList; track item.id) {
+  @defer (on viewport) {
+    <oms-shared-return-task-list-item />
+  } @placeholder {
+    <!-- Spinner placeholder -->
+  }
+}
+```
+
+**Observation:**
+- Uses spinner as placeholder (TODO notes suggest skeleton loader)
+- Viewport-based loading may cause layout shifts
+- No prefetching strategy
+
+**Proposed Enhancements:**
+- Replace spinner with skeleton loader matching item dimensions
+- Add `@defer (on viewport; prefetch on idle)` for better UX
+- Consider virtual scrolling for large task lists
+
+**Impact**: Low - current implementation works, improvements would enhance UX
+
+#### 3. Filter Query Complexity (Medium Priority)
+
+**Current State:**
+```typescript
+const filter: Record<string, unknown> =
+  appearance === 'review' ? { eob: true } : { completed: false };
+```
+
+**Observation:**
+- Simple boolean filter for review mode (`eob: true`)
+- Incomplete task filter for main mode (`completed: false`)
+- No pagination or advanced filtering
+
+**Potential Issues:**
+- Large task lists not paginated (could impact performance)
+- Filter criteria hardcoded (not extensible)
+- No user-configurable filtering
+
+**Proposed Enhancements:**
+- Extract filter logic to separate helper function
+- Add pagination support via QueryToken
+- Allow custom filter injection via component input
+- Add sort options (by date, product, type)
+
+**Impact**: Medium - works for current use cases, scalability concerns
+
+#### 4. Error Recovery Strategy (Medium Priority)
+
+**Current State:**
+```typescript
+catch (error) {
+  this.#logger.error('Error completing task', error);
+  // No user feedback or retry mechanism
+}
+```
+
+**Observation:**
+- Errors logged but not surfaced to UI
+- No retry mechanism for failed operations
+- User has no indication task completion failed
+- Store may be in inconsistent state after error
+
+**Proposed Enhancements:**
+- Add toast notification on task action failure
+- Implement retry mechanism with exponential backoff
+- Show error indicator on failed task items
+- Revert optimistic updates on error
+
+**Impact**: Medium - impacts user experience when errors occur
+
+### Performance Considerations
+
+#### 1. Viewport-Based Rendering
+- Only renders tasks visible in viewport
+- Reduces initial render time for large lists
+- Trade-off: Layout shifts on scroll
+
+#### 2. Change Detection Optimization
+```typescript
+changeDetection: ChangeDetectionStrategy.OnPush
+```
+- Only checks component when inputs change or events fire
+- Reduces unnecessary change detection cycles
+- Compatible with signal-based reactivity
+
+#### 3. Store Entity Management
+```typescript
+// Efficient entity lookup by process ID
+const tasks = this.#store.entityMap()[processId].data;
+```
+- O(1) lookup time via object map
+- No array iteration for entity access
+- Normalized data structure
+
+#### 4. Task Item Tracking
+```html
+@for (item of taskList; track item.id) {
+```
+- Angular tracks items by ID for efficient DOM updates
+- Prevents unnecessary re-renders on list changes
+- Stable item references
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Skeleton Loading** - Replace spinner placeholders with skeleton UI
+2. **Virtual Scrolling** - Add `@angular/cdk` virtual scroll for large lists
+3. **Undo Functionality** - Allow task completion undo within timeout
+4. **Bulk Actions** - Multi-select and bulk complete/update
+5. **Advanced Filtering** - User-configurable filters and sorting
+6. **Pagination** - Add pagination for large task lists
+7. **Error UI** - User-visible error states and retry buttons
+8. **Accessibility** - ARIA labels and keyboard navigation
+9. **Analytics** - Track task completion rates and times
+10. **Export Functionality** - Export task list to CSV/PDF
+
+## Dependencies
+
+### Required Libraries
+
+#### Angular Core
+- `@angular/core` - Angular framework, signals, effects, dependency injection
+
+#### OMS Domain
+- `@isa/oms/data-access` - Data services, stores, and models
+  - `ReturnTaskListService` - Task CRUD operations
+  - `ReturnTaskListStore` - NgRx Signals store
+  - `PrintTolinoReturnReceiptService` - Receipt printing
+  - `ReceiptItemTaskListItem` - Task data model
+  - `TaskActionType` - Action type definitions
+  - `QueryTokenInput` - Query parameters
+
+#### OMS Shared
+- `@isa/oms/shared/product-info` - Product display component
+
+#### UI Components
+- `@isa/ui/buttons` - Button components
+  - `ButtonComponent` - Standard button
+  - `IconButtonComponent` - Icon-only button
+  - `InfoButtonComponent` - Info button with icon
+
+#### Core Services
+- `@isa/core/tabs` - Tab context management
+  - `injectTabId()` - Process ID from tab context
+- `@isa/core/logging` - Logging infrastructure
+  - `logger()` - Logger instance injection
+  - `provideLoggerContext()` - Logger context provider
+
+#### Icons
+- `@isa/icons` - ISA icon set
+  - `isaActionCheck` - Checkmark icon
+  - `isaActionPrinter` - Printer icon
+- `@ng-icons/core` - Icon component infrastructure
+
+#### State Management
+- `@ngrx/signals` - Signal-based state management
+- `@ngrx/operators` - RxJS operators for NgRx
+
+#### Utilities
+- `rxjs` - Reactive programming
+- `zod` - Schema validation (indirect via services)
+
+### Generated API Clients
+- `@generated/swagger/oms-api` - OMS API client (indirect via services)
+
+### Development Dependencies
+- `jest` - Testing framework
+- `jest-preset-angular` - Angular-specific Jest configuration
+- `@angular/compiler-cli` - Angular compiler
+- `typescript` - TypeScript compiler
+
+### Path Alias
+
+Import from: `@isa/oms/shared/task-list`
+
+**Example:**
+```typescript
+import { ReturnTaskListComponent } from '@isa/oms/shared/task-list';
+```
+
+## Testing
+
+The library uses **Jest** with **Angular Testing Utilities** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test return-task-list --skip-nx-cache
+
+# Run tests with coverage
+npx nx test return-task-list --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test return-task-list --watch
+
+# Run specific test file
+npx nx test return-task-list --testFile=src/lib/return-task-list/return-task-list.component.spec.ts --skip-nx-cache
+```
+
+### Test Structure (Recommended)
+
+#### Testing ReturnTaskListComponent
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach, jest } from '@jest/globals';
+import { ReturnTaskListComponent } from './return-task-list.component';
+import { ReturnTaskListStore } from '@isa/oms/data-access';
+import { signal } from '@angular/core';
+
+describe('ReturnTaskListComponent', () => {
+  let component: ReturnTaskListComponent;
+  let fixture: ComponentFixture<ReturnTaskListComponent>;
+  let mockStore: jest.Mocked<typeof ReturnTaskListStore>;
+
+  beforeEach(async () => {
+    // Mock store
+    mockStore = {
+      entityMap: jest.fn(() => ({})),
+      fetchTaskListItems: jest.fn(),
+      updateTaskListItem: jest.fn()
+    } as any;
+
+    await TestBed.configureTestingModule({
+      imports: [ReturnTaskListComponent],
+      providers: [
+        { provide: ReturnTaskListStore, useValue: mockStore }
+      ]
+    }).compileComponents();
+
+    fixture = TestBed.createComponent(ReturnTaskListComponent);
+    component = fixture.componentInstance;
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+
+  it('should filter completed tasks in main mode', () => {
+    // Arrange
+    fixture.componentRef.setInput('appearance', 'main');
+    const mockTasks = [
+      { id: 1, completed: false },
+      { id: 2, completed: true },
+      { id: 3, completed: false }
+    ];
+    mockStore.entityMap.mockReturnValue({
+      123: { data: mockTasks, status: 'Success', id: 123 }
+    });
+
+    // Act
+    const tasks = component.taskListItems();
+
+    // Assert
+    expect(tasks).toHaveLength(2);
+    expect(tasks.every(t => !t.completed)).toBe(true);
+  });
+
+  it('should show all tasks in review mode', () => {
+    // Arrange
+    fixture.componentRef.setInput('appearance', 'review');
+    const mockTasks = [
+      { id: 1, completed: false },
+      { id: 2, completed: true }
+    ];
+    mockStore.entityMap.mockReturnValue({
+      123: { data: mockTasks, status: 'Success', id: 123 }
+    });
+
+    // Act
+    const tasks = component.taskListItems();
+
+    // Assert
+    expect(tasks).toHaveLength(2);
+  });
+
+  it('should complete task and update store', async () => {
+    // Arrange
+    const mockService = {
+      completeTask: jest.fn(() => Promise.resolve({ id: 1, completed: true }))
+    };
+    component['#returnTaskListService'] = mockService as any;
+
+    // Act
+    await component.completeTask(1);
+
+    // Assert
+    expect(mockService.completeTask).toHaveBeenCalledWith(1);
+    expect(mockStore.updateTaskListItem).toHaveBeenCalled();
+  });
+});
+```
+
+#### Testing ReturnTaskListItemComponent
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach } from '@jest/globals';
+import { ReturnTaskListItemComponent } from './return-task-list-item.component';
+import { ReceiptItemTaskListItem } from '@isa/oms/data-access';
+
+describe('ReturnTaskListItemComponent', () => {
+  let component: ReturnTaskListItemComponent;
+  let fixture: ComponentFixture<ReturnTaskListItemComponent>;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      imports: [ReturnTaskListItemComponent]
+    }).compileComponents();
+
+    fixture = TestBed.createComponent(ReturnTaskListItemComponent);
+    component = fixture.componentInstance;
+  });
+
+  it('should emit action on complete button click', () => {
+    // Arrange
+    const mockItem: ReceiptItemTaskListItem = {
+      id: 123,
+      type: 'OK',
+      completed: false
+    };
+    fixture.componentRef.setInput('item', mockItem);
+
+    let emittedAction;
+    component.action.subscribe(action => emittedAction = action);
+
+    // Act
+    component.onActionClick({ type: 'OK' });
+
+    // Assert
+    expect(emittedAction).toEqual({
+      taskId: 123,
+      type: 'OK'
+    });
+  });
+
+  it('should display UNKNOWN task action buttons', () => {
+    // Arrange
+    const mockItem: ReceiptItemTaskListItem = {
+      id: 123,
+      type: 'UNKNOWN',
+      completed: false,
+      processingComment: 'Prüfen Sie das Produkt'
+    };
+    fixture.componentRef.setInput('item', mockItem);
+
+    // Act
+    fixture.detectChanges();
+
+    // Assert
+    const buttons = fixture.nativeElement.querySelectorAll(
+      '[data-what="button"]'
+    );
+    expect(buttons.length).toBe(2); // OK and NOK buttons
+  });
+
+  it('should show completed status when task is completed', () => {
+    // Arrange
+    const mockItem: ReceiptItemTaskListItem = {
+      id: 123,
+      type: 'OK',
+      completed: true
+    };
+    fixture.componentRef.setInput('item', mockItem);
+
+    // Act
+    fixture.detectChanges();
+
+    // Assert
+    const completedInfo = fixture.nativeElement.querySelector(
+      '[data-what="info"][data-which="completed"]'
+    );
+    expect(completedInfo).toBeTruthy();
+    expect(completedInfo.textContent).toContain('Abgeschlossen');
+  });
+
+  it('should display Tolino print button when action exists', () => {
+    // Arrange
+    const mockItem: ReceiptItemTaskListItem = {
+      id: 123,
+      type: 'OK',
+      completed: false,
+      actions: [
+        { key: 'PRINT_TOLINO_RETURN_RECEIPT', value: 'true' }
+      ]
+    };
+    fixture.componentRef.setInput('item', mockItem);
+
+    // Act
+    fixture.detectChanges();
+
+    // Assert
+    const printButton = fixture.nativeElement.querySelector(
+      '[data-which="print-receipt"]'
+    );
+    expect(printButton).toBeTruthy();
+  });
+});
+```
+
+### Test Coverage Goals
+
+- **Component Logic**: 80%+ coverage
+- **Template Rendering**: Test all conditional paths (@if, @for)
+- **User Interactions**: Test all button clicks and events
+- **Store Integration**: Mock store methods and verify calls
+- **E2E Attributes**: Verify all data-what/data-which attributes exist
+
+### E2E Testing
+
+The component includes comprehensive E2E testing attributes:
+
+```typescript
+// Example Playwright test
+import { test, expect } from '@playwright/test';
+
+test.describe('Return Task List', () => {
+  test('should complete task on button click', async ({ page }) => {
+    // Navigate to page with task list
+    await page.goto('/return-search');
+
+    // Click complete button
+    await page.click('[data-what="button"][data-which="complete"]');
+
+    // Verify task marked as completed
+    await expect(
+      page.locator('[data-what="info"][data-which="completed"]')
+    ).toBeVisible();
+  });
+
+  test('should update UNKNOWN task to OK', async ({ page }) => {
+    await page.goto('/return-search');
+
+    // Click "Ja verkaufsfähig" button
+    await page.click('[data-what="button"][data-which="resellable"]');
+
+    // Verify complete button appears (task type updated)
+    await expect(
+      page.locator('[data-what="button"][data-which="complete"]')
+    ).toBeVisible();
+  });
+
+  test('should print Tolino receipt', async ({ page }) => {
+    await page.goto('/return-search');
+
+    // Click print receipt button
+    const [download] = await Promise.all([
+      page.waitForEvent('download'),
+      page.click('[data-what="button"][data-which="print-receipt"]')
+    ]);
+
+    // Verify download started
+    expect(download).toBeTruthy();
+  });
+});
+```
+
+## Best Practices
+
+### 1. Always Use Appearance Mode Appropriately
+
+```typescript
+// ✅ GOOD: Main workflow for processing tasks
+<oms-shared-return-task-list [appearance]="'main'"></oms-shared-return-task-list>
+
+// ✅ GOOD: Review workflow for checking all tasks
+<oms-shared-return-task-list [appearance]="'review'"></oms-shared-return-task-list>
+
+// ❌ BAD: Using review mode in main workflow
+// (Shows completed tasks when user expects only open tasks)
+```
+
+### 2. Rely on Tab Context for Process ID
+
+```typescript
+// ✅ GOOD: Component automatically uses tab-based process ID
+// No manual process ID management needed
+<oms-shared-return-task-list [appearance]="'main'"></oms-shared-return-task-list>
+
+// ❌ BAD: Trying to manually manage process IDs
+// Component handles this internally via injectTabId()
+```
+
+### 3. Trust Optimistic Updates
+
+```typescript
+// ✅ GOOD: Let component handle store updates
+// User sees immediate feedback
+await component.completeTask(123);
+
+// ❌ BAD: Manual store updates after completion
+// Creates race conditions and duplicate updates
+await service.completeTask(123);
+store.updateTaskListItem(...); // Component already does this
+```
+
+### 4. Use E2E Attributes in Custom Templates
+
+```typescript
+// ✅ GOOD: Include data attributes for testing
+<button
+  (click)="completeTask()"
+  data-what="button"
+  data-which="custom-complete"
+>
+  Complete Task
+</button>
+
+// ❌ BAD: No testing attributes
+<button (click)="completeTask()">
+  Complete Task
+</button>
+```
+
+### 5. Monitor Store State for Advanced Use Cases
+
+```typescript
+// ✅ GOOD: Access store for derived data only
+taskCount = computed(() => {
+  const entity = this.#store.entityMap()[this.processId()];
+  return entity?.data?.filter(item => !item.completed).length ?? 0;
+});
+
+// ❌ BAD: Direct store manipulation
+this.#store.entityMap()[processId].data = newData; // Use updateTaskListItem()
+```
+
+### 6. Handle Appearance Mode Switching Carefully
+
+```typescript
+// ✅ GOOD: Consider data refetch when switching modes
+const appearance = signal<'main' | 'review'>('main');
+
+effect(() => {
+  // Component effect will refetch with appropriate filter
+  console.log('Appearance changed to', appearance());
+});
+
+// ❌ BAD: Switching without understanding filter implications
+// Review mode shows EOB tasks, main mode shows incomplete tasks
+```
+
+### 7. Respect Component Encapsulation
+
+```typescript
+// ✅ GOOD: Use component as black box
+<oms-shared-return-task-list [appearance]="mode()"></oms-shared-return-task-list>
+
+// ❌ BAD: Trying to access internal component state
+const tasks = component.taskListItems(); // Component manages this
+```
+
+### 8. Style with CSS Classes, Not Inline Styles
+
+```scss
+// ✅ GOOD: Override via CSS classes
+.oms-shared-return-task-list-item__main {
+  width: 20rem;
+  padding: 2rem;
+}
+
+// ❌ BAD: Inline styles in template
+<oms-shared-return-task-list
+  style="width: 20rem;"
+></oms-shared-return-task-list>
+```
+
+### 9. Leverage Deferred Rendering Performance
+
+```typescript
+// ✅ GOOD: Component handles viewport-based loading
+// Large task lists render efficiently
+<oms-shared-return-task-list [appearance]="'main'"></oms-shared-return-task-list>
+
+// ❌ BAD: Manual pagination when component handles it
+// Trust the @defer implementation
+```
+
+### 10. Consider Accessibility
+
+```typescript
+// ✅ GOOD: Wrap in semantic HTML
+<main role="main">
+  <h1>Aufgaben</h1>
+  <oms-shared-return-task-list [appearance]="'main'"></oms-shared-return-task-list>
+</main>
+
+// ⚠️ CONSIDERATION: Component could add ARIA labels
+// Future enhancement for screen reader support
+```
+
+### 11. Error Handling Pattern
+
+```typescript
+// ✅ GOOD: Component logs errors automatically
+// Monitor logs for task completion failures
+// Consider adding error UI in future enhancement
+
+// ⚠️ CURRENT LIMITATION: Errors not visible to users
+// Plan for user feedback in production deployments
+```
+
+### 12. Testing Strategy
+
+```typescript
+// ✅ GOOD: Test component behavior, not implementation
+it('should complete task', async () => {
+  const button = fixture.nativeElement.querySelector('[data-which="complete"]');
+  button.click();
+
+  await fixture.whenStable();
+
+  expect(mockStore.updateTaskListItem).toHaveBeenCalled();
+});
+
+// ❌ BAD: Testing internal signals
+it('should have taskListItems signal', () => {
+  expect(component.taskListItems).toBeDefined(); // Too implementation-specific
+});
+```
+
+---
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/oms/utils/translation/README.md b/libs/oms/utils/translation/README.md
index a80724935..e6a553604 100644
--- a/libs/oms/utils/translation/README.md
+++ b/libs/oms/utils/translation/README.md
@@ -1,7 +1,1211 @@
-# oms-utils-translation
+# @isa/oms/utils/translation
 
-This library was generated with [Nx](https://nx.dev).
+A lightweight translation utility library for OMS receipt types providing human-readable German translations through both service-based and pipe-based interfaces.
 
-## Running unit tests
+## Overview
 
-Run `nx test oms-utils-translation` to execute the unit tests.
+The OMS Translation utility library provides a simple, extensible translation system for the OMS `ReceiptType` enum. It offers a clean abstraction for translating receipt type codes (numeric enums) into human-readable German text, with support for custom translation overrides via Angular's dependency injection system. The library includes both a service for programmatic translations and an Angular pipe for declarative template usage.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Receipt Types](#receipt-types)
+- [Custom Translations](#custom-translations)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **13 receipt type translations** - Complete German translation coverage for all OMS receipt types
+- **Service-based translation** - `ReceiptTypeTranslationService` for programmatic use
+- **Angular pipe** - `omsReceiptTypeTranslation` pipe for template-based translation
+- **Dependency injection** - Full DI support with `providedIn: 'root'`
+- **Custom overrides** - Replace default translations with custom implementations
+- **Fallback handling** - Automatic enum name fallback for missing translations
+- **Type-safe** - Strongly typed translation dictionary with TypeScript
+- **Zero configuration** - Works out of the box with sensible defaults
+- **Lightweight** - Minimal dependencies, purely translation focused
+
+## Quick Start
+
+### 1. Import and Use the Service
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { ReceiptTypeTranslationService } from '@isa/oms/utils/translation';
+import { ReceiptType } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-receipt-display',
+  template: '...'
+})
+export class ReceiptDisplayComponent {
+  #translationService = inject(ReceiptTypeTranslationService);
+
+  displayReceiptType(type: ReceiptType): void {
+    const translation = this.#translationService.translate(type);
+    console.log(translation); // Output: "Lieferschein"
+  }
+}
+```
+
+### 2. Use the Pipe in Templates
+
+```typescript
+import { Component } from '@angular/core';
+import { ReceiptTypeTranslationPipe } from '@isa/oms/utils/translation';
+import { ReceiptType } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-receipt-list',
+  standalone: true,
+  imports: [ReceiptTypeTranslationPipe],
+  template: `
+    <div>
+      <span>{{ receiptType | omsReceiptTypeTranslation }}</span>
+    </div>
+  `
+})
+export class ReceiptListComponent {
+  receiptType = ReceiptType.ShippingNote; // Displays: "Lieferschein"
+}
+```
+
+### 3. Simple Example with Multiple Types
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { ReceiptTypeTranslationPipe } from '@isa/oms/utils/translation';
+import { ReceiptType } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-receipt-types',
+  standalone: true,
+  imports: [ReceiptTypeTranslationPipe],
+  template: `
+    <ul>
+      @for (type of receiptTypes; track type) {
+        <li>{{ type | omsReceiptTypeTranslation }}</li>
+      }
+    </ul>
+  `
+})
+export class ReceiptTypesComponent {
+  receiptTypes = [
+    ReceiptType.ShippingNote,      // "Lieferschein"
+    ReceiptType.Invoice,            // "Rechnung"
+    ReceiptType.CreditNote,         // "Gutschrift"
+    ReceiptType.ReturnReceipt       // "Retourenbeleg"
+  ];
+}
+```
+
+## Core Concepts
+
+### Translation Dictionary
+
+The library provides a default translation dictionary mapping each `ReceiptType` enum value to its German translation:
+
+```typescript
+const receiptTypeTranslations = {
+  [ReceiptType.NotSet]: 'Nicht gesetzt',
+  [ReceiptType.ShippingNote]: 'Lieferschein',
+  [ReceiptType.CreditNote]: 'Gutschrift',
+  [ReceiptType.CollectiveShippingNote]: 'Sammellieferschein',
+  [ReceiptType.CollectiveCreditNote]: 'Sammelgutschrift',
+  [ReceiptType.BonusCardCollectiveShippingNote]: 'Bonuskarte Sammellieferschein',
+  [ReceiptType.BonusCardCollectiveCreditNote]: 'Bonuskarte Sammelgutschrift',
+  [ReceiptType.PaymentReceipt]: 'Zahlungsbeleg',
+  [ReceiptType.Invoice]: 'Rechnung',
+  [ReceiptType.CollectiveInvoice]: 'Sammelrechnung',
+  [ReceiptType.ProformaInvoice]: 'Proforma-Rechnung',
+  [ReceiptType.CashReceipt]: 'Kassenbeleg',
+  [ReceiptType.ReturnReceipt]: 'Retourenbeleg',
+};
+```
+
+### ReceiptType Enum Structure
+
+The `ReceiptType` enum from `@isa/oms/data-access` uses bit flag values:
+
+```typescript
+export enum ReceiptType {
+  NotSet = 0,                              // No receipt type set
+  ShippingNote = 1,                        // Standard shipping document
+  CreditNote = 2,                          // Credit/refund document
+  CollectiveShippingNote = 4,              // Batch shipping document
+  CollectiveCreditNote = 8,                // Batch credit document
+  BonusCardCollectiveShippingNote = 16,    // Bonus card batch shipping
+  BonusCardCollectiveCreditNote = 32,      // Bonus card batch credit
+  PaymentReceipt = 64,                     // Payment confirmation
+  Invoice = 128,                           // Customer invoice
+  CollectiveInvoice = 256,                 // Batch invoice
+  ProformaInvoice = 512,                   // Pro forma invoice
+  CashReceipt = 1024,                      // Cash register receipt
+  ReturnReceipt = 2048,                    // Return/remission receipt
+}
+```
+
+**Note**: While the enum uses bit flag values (powers of 2), the current implementation treats them as discrete values, not as combinable flags. Each receipt has a single type.
+
+### Dependency Injection Pattern
+
+The library uses Angular's dependency injection system with an `InjectionToken`:
+
+```typescript
+export const RECEIPT_TYPE_TRANSLATION = new InjectionToken<ReceiptTypeTranslation>(
+  'RECEIPT_TYPE_TRANSLATION',
+  {
+    factory() {
+      return receiptTypeTranslations; // Default translations
+    },
+  }
+);
+```
+
+This pattern enables:
+1. **Default behavior** - Automatic injection of default translations
+2. **Custom overrides** - Provide custom translations at any level (root, module, component)
+3. **Testability** - Easy mocking in unit tests
+4. **Type safety** - TypeScript ensures translation completeness
+
+### Fallback Mechanism
+
+The service includes intelligent fallback handling:
+
+```typescript
+translate(type: ReceiptType): string {
+  return this.#translation[type] ?? ReceiptType[type];
+}
+```
+
+**Behavior**:
+- **Translation exists**: Returns the German translation
+- **Translation missing**: Returns the enum name as a string (e.g., "ShippingNote")
+- **Invalid type**: Returns the numeric value as a string (e.g., "999")
+
+This ensures the system never crashes, even with unexpected or new receipt types.
+
+## API Reference
+
+### ReceiptTypeTranslationService
+
+Main service for programmatic receipt type translation.
+
+#### `translate(type: ReceiptType): string`
+
+Translates a receipt type enum value to its German text representation.
+
+**Parameters:**
+- `type: ReceiptType` - The receipt type enum value to translate
+
+**Returns:** `string` - German translation, or enum name if translation missing
+
+**Example:**
+```typescript
+import { inject } from '@angular/core';
+import { ReceiptTypeTranslationService } from '@isa/oms/utils/translation';
+import { ReceiptType } from '@isa/oms/data-access';
+
+const service = inject(ReceiptTypeTranslationService);
+
+service.translate(ReceiptType.Invoice);           // "Rechnung"
+service.translate(ReceiptType.ShippingNote);      // "Lieferschein"
+service.translate(ReceiptType.NotSet);            // "Nicht gesetzt"
+```
+
+**Fallback behavior:**
+```typescript
+// Missing translation
+service.translate(999 as ReceiptType);  // "999"
+
+// All standard types have translations
+service.translate(ReceiptType.CashReceipt);  // "Kassenbeleg"
+```
+
+### ReceiptTypeTranslationPipe
+
+Angular pipe for declarative template-based translation.
+
+#### `transform(value?: ReceiptType): string`
+
+**Pipe Name:** `omsReceiptTypeTranslation`
+
+**Parameters:**
+- `value?: ReceiptType` - Receipt type to translate (defaults to `ReceiptType.NotSet`)
+
+**Returns:** `string` - German translation
+
+**Example:**
+```typescript
+import { Component } from '@angular/core';
+import { ReceiptTypeTranslationPipe } from '@isa/oms/utils/translation';
+import { ReceiptType } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-example',
+  standalone: true,
+  imports: [ReceiptTypeTranslationPipe],
+  template: `
+    <!-- Simple usage -->
+    <span>{{ receiptType | omsReceiptTypeTranslation }}</span>
+
+    <!-- With default fallback (NotSet) -->
+    <span>{{ undefined | omsReceiptTypeTranslation }}</span>
+
+    <!-- In conditional -->
+    @if (receipt) {
+      <span>{{ receipt.type | omsReceiptTypeTranslation }}</span>
+    }
+  `
+})
+export class ExampleComponent {
+  receiptType = ReceiptType.Invoice;
+}
+```
+
+### Types and Tokens
+
+#### `ReceiptTypeTranslation`
+
+Type representing the translation dictionary structure.
+
+```typescript
+export type ReceiptTypeTranslation = {
+  [ReceiptType.NotSet]: string;
+  [ReceiptType.ShippingNote]: string;
+  [ReceiptType.CreditNote]: string;
+  [ReceiptType.CollectiveShippingNote]: string;
+  [ReceiptType.CollectiveCreditNote]: string;
+  [ReceiptType.BonusCardCollectiveShippingNote]: string;
+  [ReceiptType.BonusCardCollectiveCreditNote]: string;
+  [ReceiptType.PaymentReceipt]: string;
+  [ReceiptType.Invoice]: string;
+  [ReceiptType.CollectiveInvoice]: string;
+  [ReceiptType.ProformaInvoice]: string;
+  [ReceiptType.CashReceipt]: string;
+  [ReceiptType.ReturnReceipt]: string;
+};
+```
+
+#### `RECEIPT_TYPE_TRANSLATION`
+
+Injection token for providing custom translations.
+
+```typescript
+export const RECEIPT_TYPE_TRANSLATION: InjectionToken<ReceiptTypeTranslation>;
+```
+
+### Provider Functions
+
+#### `provideReceiptTypeTranslation(translation: ReceiptTypeTranslation): Provider[]`
+
+Creates providers for custom receipt type translations.
+
+**Parameters:**
+- `translation: ReceiptTypeTranslation` - Custom translation dictionary
+
+**Returns:** `Provider[]` - Angular providers array
+
+**Example:**
+```typescript
+import { provideReceiptTypeTranslation } from '@isa/oms/utils/translation';
+import { ReceiptType } from '@isa/oms/data-access';
+
+const customTranslations = {
+  [ReceiptType.NotSet]: 'Kein Typ',
+  [ReceiptType.ShippingNote]: 'Versandschein',
+  [ReceiptType.Invoice]: 'Faktura',
+  // ... other translations
+};
+
+export const appConfig = {
+  providers: [
+    provideReceiptTypeTranslation(customTranslations)
+  ]
+};
+```
+
+## Usage Examples
+
+### Basic Template Usage
+
+```typescript
+import { Component } from '@angular/core';
+import { ReceiptTypeTranslationPipe } from '@isa/oms/utils/translation';
+import { ReceiptType } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-receipt-header',
+  standalone: true,
+  imports: [ReceiptTypeTranslationPipe],
+  template: `
+    <div class="receipt-header">
+      <h2>{{ receiptType | omsReceiptTypeTranslation }}</h2>
+      <p>Receipt #{{ receiptNumber }}</p>
+    </div>
+  `
+})
+export class ReceiptHeaderComponent {
+  receiptType = ReceiptType.Invoice;
+  receiptNumber = '12345';
+}
+```
+
+### Service-Based Translation in Component Logic
+
+```typescript
+import { Component, inject, OnInit } from '@angular/core';
+import { ReceiptTypeTranslationService } from '@isa/oms/utils/translation';
+import { ReceiptType } from '@isa/oms/data-access';
+
+interface Receipt {
+  id: number;
+  type: ReceiptType;
+  amount: number;
+}
+
+@Component({
+  selector: 'app-receipt-summary',
+  template: `
+    <div>
+      <h3>Receipt Summary</h3>
+      <p>{{ summaryText }}</p>
+    </div>
+  `
+})
+export class ReceiptSummaryComponent implements OnInit {
+  #translationService = inject(ReceiptTypeTranslationService);
+
+  summaryText = '';
+
+  receipts: Receipt[] = [
+    { id: 1, type: ReceiptType.Invoice, amount: 100 },
+    { id: 2, type: ReceiptType.CreditNote, amount: 50 },
+    { id: 3, type: ReceiptType.ShippingNote, amount: 0 }
+  ];
+
+  ngOnInit(): void {
+    this.summaryText = this.generateSummary();
+  }
+
+  private generateSummary(): string {
+    return this.receipts
+      .map(r => {
+        const typeText = this.#translationService.translate(r.type);
+        return `${typeText}: €${r.amount}`;
+      })
+      .join(', ');
+    // Output: "Rechnung: €100, Gutschrift: €50, Lieferschein: €0"
+  }
+}
+```
+
+### Dynamic Receipt Type Display
+
+```typescript
+import { Component, input, computed } from '@angular/core';
+import { ReceiptTypeTranslationPipe } from '@isa/oms/utils/translation';
+import { ReceiptType } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-receipt-badge',
+  standalone: true,
+  imports: [ReceiptTypeTranslationPipe],
+  template: `
+    <span [class]="badgeClass()">
+      {{ type() | omsReceiptTypeTranslation }}
+    </span>
+  `,
+  styles: [`
+    .badge { padding: 4px 8px; border-radius: 4px; }
+    .badge-invoice { background: #e3f2fd; color: #1976d2; }
+    .badge-credit { background: #e8f5e9; color: #388e3c; }
+    .badge-shipping { background: #fff3e0; color: #f57c00; }
+    .badge-return { background: #fce4ec; color: #c2185b; }
+  `]
+})
+export class ReceiptBadgeComponent {
+  type = input.required<ReceiptType>();
+
+  badgeClass = computed(() => {
+    const typeValue = this.type();
+    switch (typeValue) {
+      case ReceiptType.Invoice:
+      case ReceiptType.CollectiveInvoice:
+        return 'badge badge-invoice';
+      case ReceiptType.CreditNote:
+      case ReceiptType.CollectiveCreditNote:
+        return 'badge badge-credit';
+      case ReceiptType.ShippingNote:
+      case ReceiptType.CollectiveShippingNote:
+        return 'badge badge-shipping';
+      case ReceiptType.ReturnReceipt:
+        return 'badge badge-return';
+      default:
+        return 'badge';
+    }
+  });
+}
+```
+
+### List Display with Filtering
+
+```typescript
+import { Component, signal, computed } from '@angular/core';
+import { ReceiptTypeTranslationPipe } from '@isa/oms/utils/translation';
+import { ReceiptType } from '@isa/oms/data-access';
+
+interface ReceiptListItem {
+  id: number;
+  type: ReceiptType;
+  date: Date;
+  customer: string;
+}
+
+@Component({
+  selector: 'app-receipt-list',
+  standalone: true,
+  imports: [ReceiptTypeTranslationPipe],
+  template: `
+    <div>
+      <h3>Receipts</h3>
+      <select (change)="onFilterChange($event)">
+        <option value="">All Types</option>
+        @for (type of receiptTypes; track type.value) {
+          <option [value]="type.value">{{ type.value | omsReceiptTypeTranslation }}</option>
+        }
+      </select>
+
+      <table>
+        <thead>
+          <tr>
+            <th>ID</th>
+            <th>Type</th>
+            <th>Customer</th>
+            <th>Date</th>
+          </tr>
+        </thead>
+        <tbody>
+          @for (receipt of filteredReceipts(); track receipt.id) {
+            <tr>
+              <td>{{ receipt.id }}</td>
+              <td>{{ receipt.type | omsReceiptTypeTranslation }}</td>
+              <td>{{ receipt.customer }}</td>
+              <td>{{ receipt.date | date }}</td>
+            </tr>
+          }
+        </tbody>
+      </table>
+    </div>
+  `
+})
+export class ReceiptListComponent {
+  receiptTypes = [
+    { value: ReceiptType.Invoice },
+    { value: ReceiptType.CreditNote },
+    { value: ReceiptType.ShippingNote },
+    { value: ReceiptType.ReturnReceipt }
+  ];
+
+  allReceipts = signal<ReceiptListItem[]>([
+    { id: 1, type: ReceiptType.Invoice, date: new Date(), customer: 'Customer A' },
+    { id: 2, type: ReceiptType.CreditNote, date: new Date(), customer: 'Customer B' },
+    { id: 3, type: ReceiptType.ShippingNote, date: new Date(), customer: 'Customer C' },
+  ]);
+
+  selectedFilter = signal<ReceiptType | null>(null);
+
+  filteredReceipts = computed(() => {
+    const filter = this.selectedFilter();
+    if (filter === null) return this.allReceipts();
+    return this.allReceipts().filter(r => r.type === filter);
+  });
+
+  onFilterChange(event: Event): void {
+    const value = (event.target as HTMLSelectElement).value;
+    this.selectedFilter.set(value ? Number(value) as ReceiptType : null);
+  }
+}
+```
+
+### Integration with OMS Return Details
+
+Real-world example from the OMS feature library:
+
+```typescript
+import { Component, input } from '@angular/core';
+import { ReceiptTypeTranslationPipe } from '@isa/oms/utils/translation';
+
+interface ReturnData {
+  receiptType: ReceiptType;
+  receiptNumber: string;
+  // ... other properties
+}
+
+@Component({
+  selector: 'oms-feature-return-details-data',
+  standalone: true,
+  imports: [ReceiptTypeTranslationPipe],
+  template: `
+    <div class="return-details">
+      <div class="receipt-info">
+        <label>Receipt Type:</label>
+        <span>{{ data().receiptType | omsReceiptTypeTranslation }}</span>
+      </div>
+      <div class="receipt-number">
+        <label>Receipt Number:</label>
+        <span>{{ data().receiptNumber }}</span>
+      </div>
+    </div>
+  `
+})
+export class ReturnDetailsDataComponent {
+  data = input.required<ReturnData>();
+}
+```
+
+### Programmatic Translation with Type Guards
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { ReceiptTypeTranslationService } from '@isa/oms/utils/translation';
+import { ReceiptType } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-receipt-validator',
+  template: '...'
+})
+export class ReceiptValidatorComponent {
+  #translationService = inject(ReceiptTypeTranslationService);
+
+  validateAndDescribeReceipt(type: ReceiptType | number): string {
+    // Type guard to ensure valid ReceiptType
+    if (!this.isValidReceiptType(type)) {
+      return `Invalid receipt type: ${type}`;
+    }
+
+    const translation = this.#translationService.translate(type);
+    const category = this.categorizeReceipt(type);
+
+    return `${translation} (Category: ${category})`;
+  }
+
+  private isValidReceiptType(type: ReceiptType | number): type is ReceiptType {
+    return Object.values(ReceiptType).includes(type as ReceiptType);
+  }
+
+  private categorizeReceipt(type: ReceiptType): string {
+    // Categorize based on receipt type
+    if (type === ReceiptType.Invoice || type === ReceiptType.CollectiveInvoice) {
+      return 'Billing';
+    }
+    if (type === ReceiptType.CreditNote || type === ReceiptType.CollectiveCreditNote) {
+      return 'Refund';
+    }
+    if (type === ReceiptType.ShippingNote || type === ReceiptType.CollectiveShippingNote) {
+      return 'Shipping';
+    }
+    return 'Other';
+  }
+}
+```
+
+## Receipt Types
+
+### Complete Receipt Type Reference
+
+| Enum Value | Numeric Value | German Translation | Description |
+|------------|--------------|-------------------|-------------|
+| `NotSet` | 0 | Nicht gesetzt | No receipt type assigned |
+| `ShippingNote` | 1 | Lieferschein | Standard delivery/shipping document |
+| `CreditNote` | 2 | Gutschrift | Credit note for refunds |
+| `CollectiveShippingNote` | 4 | Sammellieferschein | Batch/collective shipping document |
+| `CollectiveCreditNote` | 8 | Sammelgutschrift | Batch/collective credit note |
+| `BonusCardCollectiveShippingNote` | 16 | Bonuskarte Sammellieferschein | Bonus card batch shipping |
+| `BonusCardCollectiveCreditNote` | 32 | Bonuskarte Sammelgutschrift | Bonus card batch credit |
+| `PaymentReceipt` | 64 | Zahlungsbeleg | Payment confirmation document |
+| `Invoice` | 128 | Rechnung | Customer invoice |
+| `CollectiveInvoice` | 256 | Sammelrechnung | Batch/collective invoice |
+| `ProformaInvoice` | 512 | Proforma-Rechnung | Pro forma invoice (quotation) |
+| `CashReceipt` | 1024 | Kassenbeleg | Cash register receipt |
+| `ReturnReceipt` | 2048 | Retourenbeleg | Return/remission receipt |
+
+### Receipt Type Categories
+
+#### Shipping Documents
+- **ShippingNote** (1) - Individual shipping
+- **CollectiveShippingNote** (4) - Batch shipping
+- **BonusCardCollectiveShippingNote** (16) - Bonus card shipping
+
+#### Credit Documents
+- **CreditNote** (2) - Individual credit
+- **CollectiveCreditNote** (8) - Batch credit
+- **BonusCardCollectiveCreditNote** (32) - Bonus card credit
+
+#### Invoice Documents
+- **Invoice** (128) - Standard invoice
+- **CollectiveInvoice** (256) - Batch invoice
+- **ProformaInvoice** (512) - Quotation invoice
+
+#### Payment Documents
+- **PaymentReceipt** (64) - Payment confirmation
+- **CashReceipt** (1024) - Cash transaction
+
+#### Return Documents
+- **ReturnReceipt** (2048) - Returns/remissions
+
+### Bit Flag Architecture
+
+The enum uses bit flag values (powers of 2), allowing for potential future combination operations:
+
+```typescript
+// Current usage: Single discrete values
+const type = ReceiptType.Invoice; // 128
+
+// Potential future usage: Bitwise combinations (not currently implemented)
+// const combined = ReceiptType.Invoice | ReceiptType.ShippingNote; // 129
+```
+
+**Important**: The current implementation does not support bitwise operations. Each receipt has exactly one type.
+
+## Custom Translations
+
+### Providing Custom Translations
+
+You can override the default translations at any level of your application using the `provideReceiptTypeTranslation` function:
+
+#### Application-Level Override
+
+```typescript
+import { ApplicationConfig } from '@angular/core';
+import { provideReceiptTypeTranslation } from '@isa/oms/utils/translation';
+import { ReceiptType } from '@isa/oms/data-access';
+
+const customTranslations = {
+  [ReceiptType.NotSet]: 'Kein Typ',
+  [ReceiptType.ShippingNote]: 'Versandschein',
+  [ReceiptType.CreditNote]: 'Kreditnote',
+  [ReceiptType.CollectiveShippingNote]: 'Sammel-Versandschein',
+  [ReceiptType.CollectiveCreditNote]: 'Sammel-Kreditnote',
+  [ReceiptType.BonusCardCollectiveShippingNote]: 'Bonuskarte Sammel-Versandschein',
+  [ReceiptType.BonusCardCollectiveCreditNote]: 'Bonuskarte Sammel-Kreditnote',
+  [ReceiptType.PaymentReceipt]: 'Zahlungsnachweis',
+  [ReceiptType.Invoice]: 'Faktura',
+  [ReceiptType.CollectiveInvoice]: 'Sammel-Faktura',
+  [ReceiptType.ProformaInvoice]: 'Proforma-Faktura',
+  [ReceiptType.CashReceipt]: 'Kassenbon',
+  [ReceiptType.ReturnReceipt]: 'Rückgabe-Beleg',
+};
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideReceiptTypeTranslation(customTranslations)
+  ]
+};
+```
+
+#### Component-Level Override
+
+```typescript
+import { Component } from '@angular/core';
+import { provideReceiptTypeTranslation } from '@isa/oms/utils/translation';
+import { ReceiptTypeTranslationPipe } from '@isa/oms/utils/translation';
+import { ReceiptType } from '@isa/oms/data-access';
+
+const shortTranslations = {
+  [ReceiptType.NotSet]: 'N/A',
+  [ReceiptType.ShippingNote]: 'LS',
+  [ReceiptType.CreditNote]: 'GS',
+  [ReceiptType.CollectiveShippingNote]: 'SLS',
+  [ReceiptType.CollectiveCreditNote]: 'SGS',
+  [ReceiptType.BonusCardCollectiveShippingNote]: 'BK-SLS',
+  [ReceiptType.BonusCardCollectiveCreditNote]: 'BK-SGS',
+  [ReceiptType.PaymentReceipt]: 'ZB',
+  [ReceiptType.Invoice]: 'RE',
+  [ReceiptType.CollectiveInvoice]: 'SRE',
+  [ReceiptType.ProformaInvoice]: 'PRO',
+  [ReceiptType.CashReceipt]: 'KB',
+  [ReceiptType.ReturnReceipt]: 'RB',
+};
+
+@Component({
+  selector: 'app-compact-receipt-view',
+  standalone: true,
+  imports: [ReceiptTypeTranslationPipe],
+  providers: [
+    provideReceiptTypeTranslation(shortTranslations)
+  ],
+  template: `
+    <span class="receipt-code">
+      {{ receiptType | omsReceiptTypeTranslation }}
+    </span>
+  `
+})
+export class CompactReceiptViewComponent {
+  receiptType = ReceiptType.Invoice; // Displays: "RE"
+}
+```
+
+#### Testing with Custom Translations
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { ReceiptTypeTranslationService, provideReceiptTypeTranslation } from '@isa/oms/utils/translation';
+import { ReceiptType } from '@isa/oms/data-access';
+
+describe('Custom Translation', () => {
+  it('should use custom translations', () => {
+    const customTranslations = {
+      [ReceiptType.NotSet]: 'Custom NotSet',
+      [ReceiptType.ShippingNote]: 'Custom Shipping',
+      // ... other translations
+    };
+
+    TestBed.configureTestingModule({
+      providers: [provideReceiptTypeTranslation(customTranslations)]
+    });
+
+    const service = TestBed.inject(ReceiptTypeTranslationService);
+    expect(service.translate(ReceiptType.ShippingNote)).toBe('Custom Shipping');
+  });
+});
+```
+
+### Direct Token Override
+
+For advanced scenarios, you can provide the translation directly using the injection token:
+
+```typescript
+import { Component } from '@angular/core';
+import { RECEIPT_TYPE_TRANSLATION } from '@isa/oms/utils/translation';
+import { ReceiptType } from '@isa/oms/data-access';
+
+@Component({
+  selector: 'app-advanced',
+  providers: [
+    {
+      provide: RECEIPT_TYPE_TRANSLATION,
+      useValue: {
+        [ReceiptType.NotSet]: 'Custom Translation',
+        // ... other translations
+      }
+    }
+  ],
+  template: '...'
+})
+export class AdvancedComponent {}
+```
+
+## Testing
+
+The library uses **Jest** with **jest-preset-angular** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test oms-utils-translation --skip-nx-cache
+
+# Run tests with coverage
+npx nx test oms-utils-translation --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test oms-utils-translation --watch
+```
+
+### Test Examples
+
+#### Testing the Service
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { ReceiptTypeTranslationService } from './receipt-type-translation.service';
+import { ReceiptType } from '@isa/oms/data-access';
+
+describe('ReceiptTypeTranslationService', () => {
+  let service: ReceiptTypeTranslationService;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      providers: [ReceiptTypeTranslationService]
+    });
+    service = TestBed.inject(ReceiptTypeTranslationService);
+  });
+
+  it('should be created', () => {
+    expect(service).toBeTruthy();
+  });
+
+  it('should translate ShippingNote correctly', () => {
+    expect(service.translate(ReceiptType.ShippingNote)).toBe('Lieferschein');
+  });
+
+  it('should translate Invoice correctly', () => {
+    expect(service.translate(ReceiptType.Invoice)).toBe('Rechnung');
+  });
+
+  it('should translate NotSet correctly', () => {
+    expect(service.translate(ReceiptType.NotSet)).toBe('Nicht gesetzt');
+  });
+
+  it('should fallback to enum name for unknown types', () => {
+    const unknownType = 9999 as ReceiptType;
+    expect(service.translate(unknownType)).toBe('9999');
+  });
+
+  it('should translate all receipt types', () => {
+    const types = [
+      ReceiptType.NotSet,
+      ReceiptType.ShippingNote,
+      ReceiptType.CreditNote,
+      ReceiptType.CollectiveShippingNote,
+      ReceiptType.CollectiveCreditNote,
+      ReceiptType.BonusCardCollectiveShippingNote,
+      ReceiptType.BonusCardCollectiveCreditNote,
+      ReceiptType.PaymentReceipt,
+      ReceiptType.Invoice,
+      ReceiptType.CollectiveInvoice,
+      ReceiptType.ProformaInvoice,
+      ReceiptType.CashReceipt,
+      ReceiptType.ReturnReceipt,
+    ];
+
+    types.forEach(type => {
+      const result = service.translate(type);
+      expect(result).toBeTruthy();
+      expect(typeof result).toBe('string');
+      expect(result.length).toBeGreaterThan(0);
+    });
+  });
+});
+```
+
+#### Testing the Pipe
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { ReceiptTypeTranslationPipe } from './receipt-type-translation.pipe';
+import { ReceiptTypeTranslationService } from './receipt-type-translation.service';
+import { ReceiptType } from '@isa/oms/data-access';
+
+describe('ReceiptTypeTranslationPipe', () => {
+  let pipe: ReceiptTypeTranslationPipe;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      providers: [
+        ReceiptTypeTranslationPipe,
+        ReceiptTypeTranslationService
+      ]
+    });
+    pipe = TestBed.inject(ReceiptTypeTranslationPipe);
+  });
+
+  it('should create', () => {
+    expect(pipe).toBeTruthy();
+  });
+
+  it('should transform ShippingNote', () => {
+    expect(pipe.transform(ReceiptType.ShippingNote)).toBe('Lieferschein');
+  });
+
+  it('should transform Invoice', () => {
+    expect(pipe.transform(ReceiptType.Invoice)).toBe('Rechnung');
+  });
+
+  it('should use NotSet as default', () => {
+    expect(pipe.transform()).toBe('Nicht gesetzt');
+  });
+
+  it('should handle undefined by using default', () => {
+    expect(pipe.transform(undefined as any)).toBe('Nicht gesetzt');
+  });
+});
+```
+
+#### Testing Custom Translations
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import {
+  ReceiptTypeTranslationService,
+  provideReceiptTypeTranslation,
+  ReceiptTypeTranslation
+} from './receipt-type-translation.service';
+import { ReceiptType } from '@isa/oms/data-access';
+
+describe('Custom Receipt Type Translation', () => {
+  it('should use custom translation dictionary', () => {
+    const customTranslations: ReceiptTypeTranslation = {
+      [ReceiptType.NotSet]: 'Test NotSet',
+      [ReceiptType.ShippingNote]: 'Test Shipping',
+      [ReceiptType.CreditNote]: 'Test Credit',
+      [ReceiptType.CollectiveShippingNote]: 'Test Collective Shipping',
+      [ReceiptType.CollectiveCreditNote]: 'Test Collective Credit',
+      [ReceiptType.BonusCardCollectiveShippingNote]: 'Test Bonus Shipping',
+      [ReceiptType.BonusCardCollectiveCreditNote]: 'Test Bonus Credit',
+      [ReceiptType.PaymentReceipt]: 'Test Payment',
+      [ReceiptType.Invoice]: 'Test Invoice',
+      [ReceiptType.CollectiveInvoice]: 'Test Collective Invoice',
+      [ReceiptType.ProformaInvoice]: 'Test Proforma',
+      [ReceiptType.CashReceipt]: 'Test Cash',
+      [ReceiptType.ReturnReceipt]: 'Test Return',
+    };
+
+    TestBed.configureTestingModule({
+      providers: [provideReceiptTypeTranslation(customTranslations)]
+    });
+
+    const service = TestBed.inject(ReceiptTypeTranslationService);
+
+    expect(service.translate(ReceiptType.ShippingNote)).toBe('Test Shipping');
+    expect(service.translate(ReceiptType.Invoice)).toBe('Test Invoice');
+  });
+});
+```
+
+### Test Coverage Goals
+
+The library should maintain high test coverage:
+- **Service tests**: All translation methods and fallback behavior
+- **Pipe tests**: Transform method with various inputs
+- **Custom provider tests**: Override functionality
+- **Integration tests**: Pipe using service correctly
+
+## Architecture Notes
+
+### Current Architecture
+
+The library follows a simple, focused architecture:
+
+```
+Components/Features
+       ↓
+  ReceiptTypeTranslationPipe (template usage)
+       ↓
+  ReceiptTypeTranslationService (business logic)
+       ↓
+  RECEIPT_TYPE_TRANSLATION (injection token)
+       ↓
+  receiptTypeTranslations (default dictionary)
+```
+
+### Design Principles
+
+1. **Single Responsibility** - Library focuses solely on receipt type translation
+2. **Dependency Injection** - Full Angular DI integration for flexibility
+3. **Type Safety** - TypeScript ensures translation completeness
+4. **Fallback Safety** - Never crashes on unknown types
+5. **Extensibility** - Easy to override translations at any level
+6. **Minimal Dependencies** - Only depends on Angular core and OMS data-access
+
+### Architectural Considerations
+
+#### 1. Standalone vs Module-Based (Completed)
+
+**Current State**: The pipe is a traditional module-based component (not standalone).
+
+**Recommendation**: Migrate to standalone component in line with Angular 20 best practices:
+
+```typescript
+// Current
+@Pipe({ name: 'omsReceiptTypeTranslation' })
+export class ReceiptTypeTranslationPipe {}
+
+// Recommended
+@Pipe({
+  name: 'omsReceiptTypeTranslation',
+  standalone: true
+})
+export class ReceiptTypeTranslationPipe {}
+```
+
+**Impact**: Low risk, improves consistency with modern Angular patterns
+
+#### 2. Internationalization (i18n) Integration (Future Enhancement)
+
+**Current State**: Hardcoded German translations.
+
+**Future Option**: Integrate with Angular i18n or external translation library:
+
+```typescript
+// Potential future implementation
+@Injectable({ providedIn: 'root' })
+export class ReceiptTypeTranslationService {
+  #translateService = inject(TranslateService);
+
+  translate(type: ReceiptType): string {
+    return this.#translateService.instant(`receipt.type.${ReceiptType[type]}`);
+  }
+}
+```
+
+**Impact**: Medium priority if multi-language support is needed
+
+#### 3. Translation Completeness Validation (Low Priority)
+
+**Current State**: TypeScript ensures all enum values have translations.
+
+**Potential Enhancement**: Runtime validation to ensure completeness:
+
+```typescript
+function validateTranslationCompleteness(
+  translations: ReceiptTypeTranslation
+): void {
+  const allTypes = Object.values(ReceiptType).filter(v => typeof v === 'number');
+  const missingTranslations = allTypes.filter(
+    type => !translations[type as ReceiptType]
+  );
+
+  if (missingTranslations.length > 0) {
+    console.warn('Missing translations for:', missingTranslations);
+  }
+}
+```
+
+**Impact**: Low priority, type safety already provides compile-time checks
+
+### Performance Considerations
+
+1. **Service Singleton** - `providedIn: 'root'` ensures single instance
+2. **Pure Pipe** - Pipe should be marked as pure for Angular optimization:
+   ```typescript
+   @Pipe({
+     name: 'omsReceiptTypeTranslation',
+     pure: true  // Recommended addition
+   })
+   ```
+3. **Dictionary Lookup** - O(1) constant time translation lookup
+4. **No External Calls** - All translations in memory, no HTTP requests
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Standalone Migration** - Convert pipe to standalone component
+2. **Pure Pipe Flag** - Add explicit pure flag for clarity
+3. **Multi-Language Support** - Integration with i18n system
+4. **Translation Caching** - Optional caching for repeated translations (likely unnecessary)
+5. **Abbreviation Support** - Optional short form translations (e.g., "LS" for Lieferschein)
+6. **Category Grouping** - Helper methods to group by category (shipping, invoice, etc.)
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework (dependency injection, pipes)
+- `@isa/oms/data-access` - OMS data models (ReceiptType enum)
+
+### Path Alias
+
+Import from: `@isa/oms/utils/translation`
+
+### Export Structure
+
+```typescript
+// Main exports
+export { ReceiptTypeTranslationService } from './lib/receipt-type/receipt-type-translation.service';
+export { ReceiptTypeTranslationPipe } from './lib/receipt-type/receipt-type-translation.pipe';
+export {
+  RECEIPT_TYPE_TRANSLATION,
+  provideReceiptTypeTranslation,
+  type ReceiptTypeTranslation
+} from './lib/receipt-type/receipt-type-translation.service';
+```
+
+## Best Practices
+
+### 1. Prefer the Pipe in Templates
+
+```typescript
+// ✅ Good - declarative and clear
+template: `<span>{{ type | omsReceiptTypeTranslation }}</span>`
+
+// ❌ Avoid - unnecessary service injection for simple display
+template: `<span>{{ getTranslation(type) }}</span>`
+```
+
+### 2. Use the Service for Business Logic
+
+```typescript
+// ✅ Good - service for programmatic translation
+generateReport(): string {
+  return this.#translationService.translate(this.receiptType);
+}
+
+// ❌ Avoid - pipe is for templates only
+```
+
+### 3. Type Safety First
+
+```typescript
+// ✅ Good - type-safe translation
+translate(type: ReceiptType): string {
+  return this.#service.translate(type);
+}
+
+// ❌ Avoid - loosing type safety
+translate(type: any): string {
+  return this.#service.translate(type);
+}
+```
+
+### 4. Custom Translations at Appropriate Level
+
+```typescript
+// ✅ Good - app-level for global overrides
+export const appConfig: ApplicationConfig = {
+  providers: [provideReceiptTypeTranslation(customTranslations)]
+};
+
+// ❌ Avoid - component-level unless truly component-specific
+```
+
+### 5. Test Translation Coverage
+
+```typescript
+// ✅ Good - test all enum values
+it('should translate all receipt types', () => {
+  Object.values(ReceiptType)
+    .filter(v => typeof v === 'number')
+    .forEach(type => {
+      const result = service.translate(type as ReceiptType);
+      expect(result).toBeTruthy();
+    });
+});
+```
+
+### 6. Handle Unknown Types Gracefully
+
+```typescript
+// ✅ Good - fallback handling
+const translation = this.#service.translate(type);
+// Always returns a string, never null/undefined
+
+// ✅ Good - explicit handling
+const translation = this.#service.translate(type);
+if (translation === ReceiptType[type]) {
+  console.warn('Unknown receipt type:', type);
+}
+```
+
+### 7. Use Standalone Flag for Pipe
+
+```typescript
+// ✅ Recommended - modern Angular pattern
+@Pipe({
+  name: 'omsReceiptTypeTranslation',
+  standalone: true,
+  pure: true
+})
+export class ReceiptTypeTranslationPipe {}
+```
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/remission/data-access/README.md b/libs/remission/data-access/README.md
index 27c4b5b54..c18f4017a 100644
--- a/libs/remission/data-access/README.md
+++ b/libs/remission/data-access/README.md
@@ -1,7 +1,1377 @@
-# remission-data-access
+# @isa/remission/data-access
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive remission (returns) management system for Angular applications supporting mandatory returns (Pflichtremission) and department overflow returns (Abteilungsremission) in retail inventory operations.
 
-## Running unit tests
+## Overview
 
-Run `nx test remission-data-access` to execute the unit tests.
+The Remission Data Access library provides a unified interface for managing product returns in a retail environment. It handles the complete lifecycle of remission operations including creating returns, managing receipts, processing return items, tracking stock levels, and managing supplier relationships. The library integrates with the generated inventory API client and provides intelligent state management, validation, and transformation of remission data.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [State Management](#state-management)
+- [Helper Functions](#helper-functions)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Dual remission types** - Pflichtremission (mandatory) and Abteilungsremission (department overflow)
+- **Complete lifecycle management** - Return creation, receipt management, item processing, completion
+- **Smart state management** - NgRx Signals store with session persistence
+- **Stock tracking** - Real-time stock information with intelligent batching
+- **Supplier management** - Automatic supplier fetching and caching
+- **Package assignment** - Track packages within receipts
+- **Return reasons** - Configurable return reasons per stock
+- **Product groups** - Department-based product categorization
+- **Capacity calculations** - Helper functions for stock and capacity analysis
+- **Zod validation** - Runtime schema validation for all parameters
+- **Request cancellation** - AbortSignal support for all async operations
+- **Comprehensive logging** - Integration with @isa/core/logging for debugging
+- **Caching strategies** - In-memory caching with decorators (@Cache, @InFlight)
+- **Batch optimization** - BatchingResource for efficient stock info fetching
+
+## Quick Start
+
+### 1. Import and Inject Services
+
+```typescript
+import { Component, inject } from '@angular/core';
+import {
+  RemissionReturnReceiptService,
+  RemissionStockService,
+  RemissionStore
+} from '@isa/remission/data-access';
+
+@Component({
+  selector: 'app-remission-manager',
+  template: '...'
+})
+export class RemissionManagerComponent {
+  #returnReceiptService = inject(RemissionReturnReceiptService);
+  #stockService = inject(RemissionStockService);
+  #remissionStore = inject(RemissionStore);
+}
+```
+
+### 2. Start a Remission Process
+
+```typescript
+async startNewRemission(): Promise<void> {
+  // Create a new remission (return + receipt)
+  const remission = await this.#returnReceiptService.createRemission({
+    returnGroup: undefined, // Auto-generated timestamp
+    receiptNumber: 'RR-2024-001'
+  });
+
+  if (remission) {
+    // Initialize the store with the created return and receipt
+    this.#remissionStore.startRemission({
+      returnId: remission.returnId,
+      receiptId: remission.receiptId
+    });
+
+    console.log('Remission started:', remission);
+  }
+}
+```
+
+### 3. Fetch and Display Remission Lists
+
+```typescript
+import { RemissionSearchService, RemissionListType } from '@isa/remission/data-access';
+
+async fetchMandatoryItems(): Promise<void> {
+  const searchService = inject(RemissionSearchService);
+  const stockService = inject(RemissionStockService);
+  const supplierService = inject(RemissionSupplierService);
+
+  const stock = await stockService.fetchAssignedStock();
+  const suppliers = await supplierService.fetchSuppliers();
+
+  const response = await searchService.fetchList({
+    assignedStockId: stock.id,
+    supplierId: suppliers[0].id,
+    take: 50,
+    skip: 0
+  });
+
+  console.log(`Total items: ${response.totalCount}`);
+  console.log(`Items returned: ${response.result?.length}`);
+}
+```
+
+### 4. Check Stock Availability
+
+```typescript
+import { StockInfoResource } from '@isa/remission/data-access';
+
+const stockInfoResource = inject(StockInfoResource);
+
+// Create a resource for a specific item
+const stockInfo = stockInfoResource.resource({
+  itemId: 12345,
+  stockId: 100
+});
+
+// Use in template or computed signals
+const inStock = computed(() => stockInfo.value()?.inStock ?? 0);
+const available = computed(() => stockInfo.value()?.available ?? 0);
+```
+
+## Core Concepts
+
+### Remission Types
+
+The library supports two distinct remission types, each with specific requirements and workflows:
+
+#### 1. Pflichtremission (Mandatory Returns)
+
+- **Purpose**: Mandatory returns based on supplier requirements
+- **Data Source**: ReturnItem entities
+- **Query Endpoint**: `RemiPflichtremissionsartikel`
+- **Characteristics**:
+  - Predefined return quantities calculated by backend
+  - Based on supplier agreements and contractual obligations
+  - Uses `addReturnItem()` to add items to receipts
+  - Typically processed first in remission workflows
+
+#### 2. Abteilungsremission (Department Overflow)
+
+- **Purpose**: Department-based overflow returns for excess stock
+- **Data Source**: ReturnSuggestion entities
+- **Query Endpoint**: `RemiUeberlauf`
+- **Characteristics**:
+  - Suggested returns based on stock levels and department capacity
+  - Uses `addReturnSuggestionItem()` to add items to receipts
+  - Supports impediment comments and remaining quantities
+  - More flexible than mandatory returns
+
+### Remission Lifecycle
+
+The complete remission workflow follows these stages:
+
+```
+1. Create Return
+   ↓
+2. Create Receipt (with receipt number)
+   ↓
+3. Assign Package (optional, can be done later)
+   ↓
+4. Add Return Items / Return Suggestions
+   ↓
+5. Update Item Impediments (if needed)
+   ↓
+6. Complete Receipt
+   ↓
+7. Complete Return
+```
+
+### Return Structure
+
+```typescript
+interface Return {
+  id: number;                          // Unique return identifier
+  returnGroup?: string;                // Group ID for related returns
+  supplier?: { id: number };           // Supplier reference
+  receipts: EntityContainer<Receipt>[]; // Associated receipts
+  status?: number;                     // Return status code
+  created?: string;                    // Creation timestamp
+  changed?: string;                    // Last modification timestamp
+}
+```
+
+### Receipt Structure
+
+```typescript
+interface Receipt {
+  id: number;                          // Unique receipt identifier
+  receiptNumber: string;               // Human-readable receipt number
+  receiptType?: number;                // Type (1 = ShippingNote)
+  stock?: { id: number };              // Stock reference
+  supplier?: { id: number };           // Supplier reference
+  items: EntityContainer<ReceiptItem>[]; // Items in this receipt
+  packages?: Array<{ packageNumber: string }>; // Assigned packages
+  completed?: boolean;                 // Completion status
+}
+```
+
+### Stock Management
+
+Stock operations use the RemissionStockService with intelligent caching:
+
+- **Assigned Stock**: The stock location assigned to the current user
+- **Stock Info**: Real-time availability for specific items
+- **Batching**: StockInfoResource batches multiple item queries into single API calls
+
+### Supplier Management
+
+Suppliers are automatically managed with memory caching:
+
+- Fetched once per session and cached in memory
+- Automatically retrieved during remission creation
+- First supplier is used as default for new returns/receipts
+
+## API Reference
+
+### RemissionReturnReceiptService
+
+Main service for managing return receipts and their lifecycle.
+
+#### `fetchRemissionReturnReceipts(params, abortSignal?): Promise<Return[]>`
+
+Fetches remission return receipts based on completion status.
+
+**Parameters:**
+- `params: FetchRemissionReturnReceiptsParams`
+  - `start?: Date` - Optional start date filter
+  - `returncompleted: boolean` - Filter by completion status
+- `abortSignal?: AbortSignal` - Optional abort signal
+
+**Returns:** Promise resolving to array of Return objects
+
+**Example:**
+```typescript
+const completedReturns = await service.fetchRemissionReturnReceipts({
+  start: new Date('2024-01-01'),
+  returncompleted: true
+});
+```
+
+#### `fetchReturn(params, abortSignal?): Promise<Return | undefined>`
+
+Fetches a specific return by ID with eager loading support.
+
+**Parameters:**
+- `params: FetchReturnParams`
+  - `returnId: number` - ID of the return to fetch
+  - `eagerLoading?: number` - Eager loading depth (default: 2)
+- `abortSignal?: AbortSignal` - Optional abort signal
+
+**Returns:** Promise resolving to Return or undefined
+
+**Example:**
+```typescript
+const returnData = await service.fetchReturn({
+  returnId: 5001,
+  eagerLoading: 3 // Load deeply nested data
+});
+```
+
+#### `createReturn(params, abortSignal?): Promise<ResponseArgs<Return> | undefined>`
+
+Creates a new return with the specified return group.
+
+**Parameters:**
+- `params: CreateReturn`
+  - `returnGroup?: string` - Optional return group ID (auto-generated if not provided)
+- `abortSignal?: AbortSignal` - Optional abort signal
+
+**Returns:** Promise resolving to ResponseArgs containing the created Return
+
+**Example:**
+```typescript
+const returnResponse = await service.createReturn({
+  returnGroup: 'GROUP-2024-001'
+});
+```
+
+#### `createReceipt(params, abortSignal?): Promise<ResponseArgs<Receipt> | undefined>`
+
+Creates a new receipt within a return.
+
+**Parameters:**
+- `params: CreateReceipt`
+  - `returnId: number` - ID of the parent return
+  - `receiptNumber?: string` - Optional receipt number
+
+**Returns:** Promise resolving to ResponseArgs containing the created Receipt
+
+**Example:**
+```typescript
+const receiptResponse = await service.createReceipt({
+  returnId: 5001,
+  receiptNumber: 'RR-2024-001'
+});
+```
+
+#### `assignPackage(params, abortSignal?): Promise<ResponseArgs<Receipt> | undefined>`
+
+Assigns a package number to a receipt.
+
+**Parameters:**
+- `params: AssignPackage`
+  - `returnId: number` - ID of the return
+  - `receiptId: number` - ID of the receipt
+  - `packageNumber: string` - Package number to assign
+
+**Returns:** Promise resolving to updated Receipt
+
+**Example:**
+```typescript
+const updatedReceipt = await service.assignPackage({
+  returnId: 5001,
+  receiptId: 101,
+  packageNumber: 'PKG-2024-001'
+});
+```
+
+#### `addReturnItem(params, abortSignal?): Promise<ReceiptReturnTuple | undefined>`
+
+Adds a mandatory return item to a receipt.
+
+**Parameters:**
+- `params: AddReturnItem`
+  - `returnId: number` - ID of the return
+  - `receiptId: number` - ID of the receipt
+  - `returnItemId: number` - ID of the return item to add
+  - `quantity: number` - Quantity to add
+  - `inStock: number` - Current stock quantity
+
+**Returns:** Promise resolving to tuple of updated Receipt and Return
+
+**Example:**
+```typescript
+const tuple = await service.addReturnItem({
+  returnId: 5001,
+  receiptId: 101,
+  returnItemId: 789,
+  quantity: 10,
+  inStock: 5
+});
+```
+
+#### `addReturnSuggestionItem(params, abortSignal?): Promise<ReceiptReturnSuggestionTuple | undefined>`
+
+Adds a department return suggestion item to a receipt.
+
+**Parameters:**
+- `params: AddReturnSuggestionItem`
+  - `returnId: number` - ID of the return
+  - `receiptId: number` - ID of the receipt
+  - `returnSuggestionId: number` - ID of the return suggestion to add
+  - `quantity: number` - Quantity to add
+  - `inStock: number` - Current stock quantity
+  - `impedimentComment?: string` - Optional impediment note
+  - `remainingQuantity?: number` - Optional remaining quantity
+
+**Returns:** Promise resolving to tuple of updated Receipt and ReturnSuggestion
+
+**Example:**
+```typescript
+const tuple = await service.addReturnSuggestionItem({
+  returnId: 5001,
+  receiptId: 101,
+  returnSuggestionId: 456,
+  quantity: 8,
+  inStock: 3,
+  impedimentComment: 'Restmenge',
+  remainingQuantity: 5
+});
+```
+
+#### `completeReturnReceipt(params): Promise<Receipt>`
+
+Finalizes a receipt, making it ready for completion.
+
+**Parameters:**
+- `params: { returnId: number; receiptId: number }`
+
+**Returns:** Promise resolving to completed Receipt
+
+**Example:**
+```typescript
+const completedReceipt = await service.completeReturnReceipt({
+  returnId: 5001,
+  receiptId: 101
+});
+```
+
+#### `completeReturn(params): Promise<Return>`
+
+Finalizes a return after all receipts are completed.
+
+**Parameters:**
+- `params: { returnId: number }`
+
+**Returns:** Promise resolving to completed Return
+
+**Example:**
+```typescript
+const completedReturn = await service.completeReturn({
+  returnId: 5001
+});
+```
+
+#### `completeReturnReceiptAndReturn(params): Promise<Return>`
+
+Convenience method that completes both receipt and return in sequence.
+
+**Parameters:**
+- `params: { returnId: number; receiptId: number }`
+
+**Returns:** Promise resolving to completed Return
+
+**Example:**
+```typescript
+const completedReturn = await service.completeReturnReceiptAndReturn({
+  returnId: 5001,
+  receiptId: 101
+});
+```
+
+#### `cancelReturnReceipt(params): Promise<void>`
+
+Cancels a receipt and its associated return.
+
+**Parameters:**
+- `params: { returnId: number; receiptId: number }`
+
+**Example:**
+```typescript
+await service.cancelReturnReceipt({
+  returnId: 5001,
+  receiptId: 101
+});
+```
+
+#### `cancelReturn(params): Promise<void>`
+
+Cancels an entire return.
+
+**Parameters:**
+- `params: { returnId: number }`
+
+**Example:**
+```typescript
+await service.cancelReturn({ returnId: 5001 });
+```
+
+#### `updateReturnItemImpediment(params): Promise<ReturnItem>`
+
+Updates the impediment comment for a return item.
+
+**Parameters:**
+- `params: UpdateItemImpediment`
+  - `itemId: number` - ID of the return item
+  - `comment: string` - Impediment comment
+
+**Returns:** Promise resolving to updated ReturnItem
+
+**Example:**
+```typescript
+const updatedItem = await service.updateReturnItemImpediment({
+  itemId: 789,
+  comment: 'Beschädigt'
+});
+```
+
+#### `updateReturnSuggestionImpediment(params): Promise<ReturnSuggestion>`
+
+Updates the impediment comment for a return suggestion.
+
+**Parameters:**
+- `params: UpdateItemImpediment`
+  - `itemId: number` - ID of the return suggestion
+  - `comment: string` - Impediment comment
+
+**Returns:** Promise resolving to updated ReturnSuggestion
+
+#### `deleteReturnItem(params): Promise<ReturnItem>`
+
+Deletes a return item from the system.
+
+**Parameters:**
+- `params: { itemId: number }`
+
+**Returns:** Promise resolving to deleted ReturnItem
+
+#### `removeReturnItemFromReturnReceipt(params): Promise<void>`
+
+Removes a return item from a receipt.
+
+**Parameters:**
+- `params: { returnId: number; receiptId: number; receiptItemId: number }`
+
+#### `createRemission(params): Promise<CreateRemission | undefined>`
+
+High-level method that creates both a return and receipt in one operation.
+
+**Parameters:**
+- `params: { returnGroup?: string; receiptNumber?: string }`
+
+**Returns:** Promise resolving to created remission with returnId, receiptId, and validation info
+
+**Example:**
+```typescript
+const remission = await service.createRemission({
+  returnGroup: undefined, // Auto-generated
+  receiptNumber: 'RR-2024-001'
+});
+
+if (remission) {
+  console.log(`Return ID: ${remission.returnId}`);
+  console.log(`Receipt ID: ${remission.receiptId}`);
+}
+```
+
+#### `remitItem(params): Promise<ReceiptReturnSuggestionTuple | ReceiptReturnTuple | undefined>`
+
+Polymorphic method that remits an item based on remission type.
+
+**Parameters:**
+- `params: { itemId: number; addItem: AddReturnItem | AddReturnSuggestionItem; type: RemissionListType }`
+
+**Returns:** Promise resolving to appropriate tuple based on type
+
+**Example:**
+```typescript
+const result = await service.remitItem({
+  itemId: 789,
+  addItem: {
+    returnId: 5001,
+    receiptId: 101,
+    quantity: 10,
+    inStock: 5
+  },
+  type: RemissionListType.Pflicht
+});
+```
+
+### RemissionStockService
+
+Service for managing stock operations with intelligent caching.
+
+#### `fetchAssignedStock(abortSignal?): Promise<Stock>`
+
+Fetches the currently assigned stock for the user. Results are cached for 5 minutes.
+
+**Decorators:** `@Cache({ ttl: CacheTimeToLive.fiveMinutes })`, `@InFlight()`
+
+**Parameters:**
+- `abortSignal?: AbortSignal` - Optional abort signal
+
+**Returns:** Promise resolving to Stock with guaranteed ID
+
+**Throws:**
+- `ResponseArgsError` - When API request fails
+- `Error` - When stock has no ID
+
+**Example:**
+```typescript
+const stock = await service.fetchAssignedStock();
+console.log(`Assigned to stock ${stock.id}: ${stock.name}`);
+```
+
+#### `fetchStock(branchId, abortSignal?): Promise<Stock | undefined>`
+
+Fetches stock for a specific branch.
+
+**Parameters:**
+- `branchId: number` - ID of the branch
+- `abortSignal?: AbortSignal` - Optional abort signal
+
+**Returns:** Promise resolving to Stock or undefined if not found
+
+**Example:**
+```typescript
+const stock = await service.fetchStock(42);
+if (stock) {
+  console.log(`Branch stock: ${stock.id}`);
+}
+```
+
+#### `fetchStockInfos(params, abortSignal?): Promise<StockInfo[]>`
+
+Fetches stock information for multiple items. Validates using FetchStockInStockSchema.
+
+**Parameters:**
+- `params: FetchStockInStock`
+  - `itemIds: number[]` - Array of item IDs
+  - `stockId?: number` - Optional stock ID (uses assigned stock if not provided)
+- `abortSignal?: AbortSignal` - Optional abort signal
+
+**Returns:** Promise resolving to array of StockInfo
+
+**Example:**
+```typescript
+const stockInfos = await service.fetchStockInfos({
+  itemIds: [123, 456, 789],
+  stockId: 100
+});
+
+stockInfos.forEach(info => {
+  console.log(`Item ${info.itemId}: ${info.inStock} in stock`);
+});
+```
+
+### RemissionSearchService
+
+Service for searching and fetching remission lists.
+
+#### `remissionListType(): Array<{ key: RemissionListTypeKey; value: RemissionListType }>`
+
+Returns all available remission list types as key-value pairs.
+
+**Returns:** Array of remission type mappings
+
+**Example:**
+```typescript
+const types = service.remissionListType();
+// [
+//   { key: 'Pflicht', value: 'Pflichtremission' },
+//   { key: 'Abteilung', value: 'Abteilungsremission' }
+// ]
+```
+
+#### `fetchList(params, abortSignal?): Promise<ListResponseArgs<ReturnItem>>`
+
+Fetches paginated list of mandatory remission items.
+
+**Parameters:**
+- `params: RemissionQueryTokenInput`
+  - `assignedStockId: number` - ID of the assigned stock
+  - `supplierId: number` - ID of the supplier
+  - `filter?: string` - Optional filter string
+  - `input?: object` - Optional input parameters
+  - `orderBy?: string` - Optional field to order by
+  - `take?: number` - Number of items to fetch
+  - `skip?: number` - Number of items to skip
+- `abortSignal?: AbortSignal` - Optional abort signal
+
+**Returns:** Promise resolving to paginated ListResponseArgs with ReturnItem array
+
+**Example:**
+```typescript
+const response = await service.fetchList({
+  assignedStockId: 100,
+  supplierId: 50,
+  orderBy: 'productName',
+  take: 50,
+  skip: 0
+});
+
+console.log(`Total: ${response.totalCount}`);
+console.log(`Returned: ${response.result?.length}`);
+```
+
+#### `fetchDepartmentList(params, abortSignal?): Promise<ListResponseArgs<ReturnSuggestion>>`
+
+Fetches paginated list of department overflow return suggestions.
+
+**Parameters:**
+- Same as `fetchList()` but returns ReturnSuggestion instead of ReturnItem
+
+**Returns:** Promise resolving to paginated ListResponseArgs with ReturnSuggestion array
+
+**Example:**
+```typescript
+const response = await service.fetchDepartmentList({
+  assignedStockId: 100,
+  supplierId: 50,
+  take: 50
+});
+```
+
+#### `fetchQuerySettings(params): Promise<QuerySettings>`
+
+Fetches query settings for mandatory remission articles.
+
+**Parameters:**
+- `params: FetchQuerySettings`
+  - `supplierId: number` - Supplier ID
+  - `assignedStockId: number` - Stock ID
+
+**Returns:** Promise resolving to QuerySettings
+
+**Example:**
+```typescript
+const settings = await service.fetchQuerySettings({
+  supplierId: 50,
+  assignedStockId: 100
+});
+```
+
+#### `fetchQueryDepartmentSettings(params): Promise<QuerySettings>`
+
+Fetches query settings for department overflow articles.
+
+**Parameters:**
+- Same as `fetchQuerySettings()`
+
+**Returns:** Promise resolving to QuerySettings
+
+#### `fetchRequiredCapacity(params): Promise<ValueTupleOfStringAndInteger[]>`
+
+Fetches required capacity information for departments.
+
+**Parameters:**
+- `params: FetchRequiredCapacity`
+  - `departments: string[]` - List of department names
+  - `supplierId: number` - Supplier ID
+  - `stockId: number` - Stock ID
+
+**Returns:** Promise resolving to array of capacity tuples
+
+**Example:**
+```typescript
+const capacity = await service.fetchRequiredCapacity({
+  departments: ['Electronics', 'Clothing'],
+  supplierId: 50,
+  stockId: 100
+});
+```
+
+#### `canAddItemToRemiList(items, abortSignal?): Promise<BatchResponseArgs<ReturnItem>>`
+
+Validates whether items can be added to the remission list.
+
+**Parameters:**
+- `items: Array<{ item: Item; quantity: number; reason: string }>`
+- `abortSignal?: AbortSignal`
+
+**Returns:** Promise resolving to batch validation results
+
+**Example:**
+```typescript
+const validationResult = await service.canAddItemToRemiList([
+  { item: catalogItem, quantity: 5, reason: 'Überschuss' }
+]);
+
+if (!validationResult.error) {
+  console.log('Can add items to list');
+}
+```
+
+#### `addToList(items, abortSignal?): Promise<ReturnItem[]>`
+
+Adds items to the remission list.
+
+**Parameters:**
+- `items: Array<{ item: Item; quantity: number; reason: string }>`
+- `abortSignal?: AbortSignal`
+
+**Returns:** Promise resolving to created ReturnItem array
+
+**Example:**
+```typescript
+const addedItems = await service.addToList([
+  { item: catalogItem, quantity: 5, reason: 'Überschuss' }
+]);
+```
+
+### RemissionSupplierService
+
+Service for managing suppliers with memory caching.
+
+#### `fetchSuppliers(abortSignal?): Promise<Supplier[]>`
+
+Fetches all suppliers for the assigned stock. Results are cached in memory.
+
+**Parameters:**
+- `abortSignal?: AbortSignal` - Optional abort signal
+
+**Returns:** Promise resolving to array of Supplier
+
+**Throws:**
+- `DataAccessError` - When no assigned stock is found
+- `Error` - When API request fails
+
+**Example:**
+```typescript
+const suppliers = await service.fetchSuppliers();
+console.log(`Found ${suppliers.length} suppliers`);
+```
+
+### BranchService
+
+Service for branch/stock operations.
+
+#### `getDefaultBranch(abortSignal?): Promise<BranchDTO>`
+
+Gets the default branch from the inventory service.
+
+**Parameters:**
+- `abortSignal?: AbortSignal` - Optional abort signal
+
+**Returns:** Promise resolving to BranchDTO
+
+**Throws:**
+- `ResponseArgsError` - When API request fails
+- `Error` - When no branch data is returned
+
+**Example:**
+```typescript
+const branch = await service.getDefaultBranch();
+console.log(`Default branch: ${branch.name} (${branch.branchNumber})`);
+```
+
+### RemissionReasonService
+
+Service for managing return reasons with caching.
+
+#### `fetchReturnReasons(abortSignal?): Promise<KeyValueStringAndString[]>`
+
+Fetches all available return reasons for the assigned stock. Cached for 5 minutes.
+
+**Decorators:** `@Cache({ ttl: CacheTimeToLive.fiveMinutes })`, `@InFlight()`
+
+**Parameters:**
+- `abortSignal?: AbortSignal` - Optional abort signal
+
+**Returns:** Promise resolving to array of key-value reason pairs
+
+**Example:**
+```typescript
+const reasons = await service.fetchReturnReasons();
+reasons.forEach(reason => {
+  console.log(`${reason.key}: ${reason.value}`);
+});
+```
+
+### RemissionProductGroupService
+
+Service for managing product groups with caching.
+
+#### `fetchProductGroups(abortSignal?): Promise<KeyValueStringAndString[]>`
+
+Fetches all available product groups for the assigned stock. Cached for 5 minutes.
+
+**Decorators:** `@Cache({ ttl: CacheTimeToLive.fiveMinutes })`, `@InFlight()`
+
+**Parameters:**
+- `abortSignal?: AbortSignal` - Optional abort signal
+
+**Returns:** Promise resolving to array of key-value product group pairs
+
+**Example:**
+```typescript
+const groups = await service.fetchProductGroups();
+groups.forEach(group => {
+  console.log(`${group.key}: ${group.value}`);
+});
+```
+
+### StockInfoResource
+
+Smart batching resource for stock information that minimizes API calls.
+
+#### `resource(params): ResourceRef<StockInfo | undefined>`
+
+Creates a resource for fetching stock info with automatic batching.
+
+**Parameters:**
+- `params: { itemId: number; stockId?: number }`
+
+**Returns:** ResourceRef that can be used in signals and templates
+
+**Example:**
+```typescript
+const stockInfoResource = inject(StockInfoResource);
+
+// In component
+const stockInfo = stockInfoResource.resource({
+  itemId: 12345,
+  stockId: 100
+});
+
+// In template or computed
+const inStock = computed(() => stockInfo.value()?.inStock ?? 0);
+const isAvailable = computed(() => (stockInfo.value()?.available ?? 0) > 0);
+```
+
+#### `reloadItems(itemIds): Promise<void>`
+
+Reloads specific items by removing them from cache.
+
+**Parameters:**
+- `itemIds: number[]` - Array of item IDs to reload
+
+**Example:**
+```typescript
+await stockInfoResource.reloadItems([123, 456, 789]);
+```
+
+## Usage Examples
+
+### Complete Remission Workflow
+
+```typescript
+import { Component, inject } from '@angular/core';
+import {
+  RemissionReturnReceiptService,
+  RemissionSearchService,
+  RemissionStockService,
+  RemissionSupplierService,
+  RemissionStore,
+  RemissionListType
+} from '@isa/remission/data-access';
+
+@Component({
+  selector: 'app-remission-workflow',
+  template: '...'
+})
+export class RemissionWorkflowComponent {
+  #returnReceiptService = inject(RemissionReturnReceiptService);
+  #searchService = inject(RemissionSearchService);
+  #stockService = inject(RemissionStockService);
+  #supplierService = inject(RemissionSupplierService);
+  #remissionStore = inject(RemissionStore);
+
+  async executeCompleteWorkflow(): Promise<void> {
+    // 1. Create remission (return + receipt)
+    const remission = await this.#returnReceiptService.createRemission({
+      returnGroup: undefined,
+      receiptNumber: 'RR-2024-001'
+    });
+
+    if (!remission) {
+      console.error('Failed to create remission');
+      return;
+    }
+
+    // 2. Start remission in store
+    this.#remissionStore.startRemission({
+      returnId: remission.returnId,
+      receiptId: remission.receiptId
+    });
+
+    // 3. Assign a package
+    await this.#returnReceiptService.assignPackage({
+      returnId: remission.returnId,
+      receiptId: remission.receiptId,
+      packageNumber: 'PKG-2024-001'
+    });
+
+    // 4. Fetch mandatory items
+    const stock = await this.#stockService.fetchAssignedStock();
+    const suppliers = await this.#supplierService.fetchSuppliers();
+
+    const mandatoryItems = await this.#searchService.fetchList({
+      assignedStockId: stock.id,
+      supplierId: suppliers[0].id,
+      take: 50
+    });
+
+    // 5. Add items to receipt
+    if (mandatoryItems.result && mandatoryItems.result.length > 0) {
+      const firstItem = mandatoryItems.result[0];
+
+      await this.#returnReceiptService.addReturnItem({
+        returnId: remission.returnId,
+        receiptId: remission.receiptId,
+        returnItemId: firstItem.id!,
+        quantity: 10,
+        inStock: 5
+      });
+    }
+
+    // 6. Complete the receipt and return
+    const completedReturn = await this.#returnReceiptService
+      .completeReturnReceiptAndReturn({
+        returnId: remission.returnId,
+        receiptId: remission.receiptId
+      });
+
+    console.log('Remission completed:', completedReturn);
+
+    // 7. Clear store state
+    this.#remissionStore.clearState();
+  }
+}
+```
+
+### Using Stock Information with Batching
+
+```typescript
+import { Component, computed, inject } from '@angular/core';
+import { StockInfoResource } from '@isa/remission/data-access';
+
+@Component({
+  selector: 'app-product-stock',
+  template: `
+    <div class="product-card">
+      <h3>{{ productName }}</h3>
+      <div class="stock-info">
+        @if (stockInfo.isLoading()) {
+          <span>Loading stock...</span>
+        } @else if (stockInfo.hasError()) {
+          <span class="error">Stock unavailable</span>
+        } @else {
+          <span>In Stock: {{ inStock() }}</span>
+          <span>Available: {{ available() }}</span>
+          <span class="status" [class.available]="isAvailable()">
+            {{ isAvailable() ? 'Available' : 'Out of Stock' }}
+          </span>
+        }
+      </div>
+    </div>
+  `
+})
+export class ProductStockComponent {
+  stockInfoResource = inject(StockInfoResource);
+
+  productId = input.required<number>();
+  productName = input.required<string>();
+  stockId = input<number>();
+
+  stockInfo = this.stockInfoResource.resource(
+    computed(() => ({
+      itemId: this.productId(),
+      stockId: this.stockId()
+    }))
+  );
+
+  inStock = computed(() => this.stockInfo.value()?.inStock ?? 0);
+  available = computed(() => this.stockInfo.value()?.available ?? 0);
+  isAvailable = computed(() => this.available() > 0);
+}
+```
+
+### Managing Remission State
+
+```typescript
+import { Component, computed, effect, inject } from '@angular/core';
+import { RemissionStore, RemissionListType } from '@isa/remission/data-access';
+
+@Component({
+  selector: 'app-remission-state-manager',
+  template: '...'
+})
+export class RemissionStateManagerComponent {
+  remissionStore = inject(RemissionStore);
+
+  // Computed signals from store
+  isRemissionActive = this.remissionStore.remissionStarted;
+  selectedItems = this.remissionStore.selectedItems;
+  selectedQuantities = this.remissionStore.selectedQuantity;
+  returnData = this.remissionStore.returnData;
+
+  // Computed values
+  totalSelectedItems = computed(() =>
+    Object.keys(this.selectedItems()).length
+  );
+
+  totalQuantity = computed(() =>
+    Object.values(this.selectedQuantities()).reduce((sum, qty) => sum + qty, 0)
+  );
+
+  // Effect to log state changes
+  constructor() {
+    effect(() => {
+      if (this.isRemissionActive()) {
+        console.log('Remission active:', {
+          returnId: this.remissionStore.returnId(),
+          receiptId: this.remissionStore.receiptId(),
+          itemsSelected: this.totalSelectedItems(),
+          totalQuantity: this.totalQuantity()
+        });
+      }
+    });
+  }
+
+  selectItem(itemId: number, item: any, quantity: number): void {
+    this.remissionStore.updateRemissionQuantity(itemId, item, quantity);
+  }
+
+  removeItem(itemId: number): void {
+    this.remissionStore.removeItemAndQuantity(itemId);
+  }
+
+  clearSelection(): void {
+    this.remissionStore.clearSelectedItems();
+  }
+
+  resetRemission(): void {
+    this.remissionStore.clearState();
+  }
+}
+```
+
+## State Management
+
+### RemissionStore
+
+The library includes a NgRx Signal Store for managing remission selection state with session persistence.
+
+#### Store State Structure
+
+```typescript
+interface RemissionState {
+  returnId: number | undefined;           // Can only be set once
+  receiptId: number | undefined;          // Can only be set once
+  selectedItems: Record<number, RemissionItem>;
+  selectedQuantity: Record<number, number>;
+}
+```
+
+#### Store Features
+
+- **Session Persistence**: State is persisted to user storage and survives page refreshes
+- **One-Time Initialization**: `returnId` and `receiptId` can only be set once via `startRemission()`
+- **Automatic Return Fetching**: Uses Angular resource to automatically fetch return data
+- **Computed Signals**: Provides reactive computed values for common queries
+
+#### Store Methods
+
+##### `startRemission({ returnId, receiptId })`
+
+Initializes the remission process. Can only be called once.
+
+**Throws:** Error if remission already started
+
+##### `reloadReturn()`
+
+Reloads the return resource to fetch latest data.
+
+##### `isCurrentRemission({ returnId, receiptId })`
+
+Checks if provided IDs match the current remission.
+
+**Returns:** boolean
+
+##### `selectRemissionItem(remissionItemId, item)`
+
+Adds or updates a selected item.
+
+##### `updateRemissionQuantity(remissionItemId, item, quantity)`
+
+Updates both the item and its quantity.
+
+##### `removeItem(remissionItemId)`
+
+Removes an item from selection.
+
+##### `removeItemAndQuantity(remissionItemId)`
+
+Removes an item and its quantity.
+
+##### `clearSelectedItems()`
+
+Clears all selected items.
+
+##### `clearState()`
+
+Resets the entire store to initial state and clears storage.
+
+#### Store Computed Signals
+
+##### `remissionStarted: Signal<boolean>`
+
+Indicates if remission has been initialized.
+
+##### `returnData: Signal<Return | undefined>`
+
+Current return data fetched from API.
+
+## Helper Functions
+
+The library provides several utility functions for calculations and data extraction.
+
+### Stock and Capacity Calculations
+
+#### `calculateStockToRemit({ availableStock, predefinedReturnQuantity?, remainingQuantityInStock? }): number`
+
+Calculates how much stock should be remitted based on available stock and predefined quantities.
+
+**Business Logic:**
+- If `predefinedReturnQuantity` is defined, use it (backend calculation takes precedence)
+- Otherwise, calculate as: `availableStock - remainingQuantityInStock`
+- Never returns negative values
+
+**Example:**
+```typescript
+// With predefined quantity (backend calculation)
+const toRemit1 = calculateStockToRemit({
+  availableStock: 50,
+  predefinedReturnQuantity: 30,
+  remainingQuantityInStock: 10
+});
+console.log(toRemit1); // 30 (uses backend value)
+
+// Without predefined quantity (fallback calculation)
+const toRemit2 = calculateStockToRemit({
+  availableStock: 50,
+  remainingQuantityInStock: 10
+});
+console.log(toRemit2); // 40 (50 - 10)
+```
+
+#### `getStockToRemit({ remissionItem, remissionListType, availableStock }): number`
+
+Higher-level function that extracts predefined quantity from a remission item based on type.
+
+**Example:**
+```typescript
+const stockToRemit = getStockToRemit({
+  remissionItem: returnItem,
+  remissionListType: RemissionListType.Pflicht,
+  availableStock: 50
+});
+```
+
+#### `calculateCapacity({ capacityValue2, capacityValue3 }): number`
+
+Calculates capacity as the minimum of two values.
+
+**Returns:** The smaller of the two capacity values
+
+**Example:**
+```typescript
+const capacity = calculateCapacity({
+  capacityValue2: 100,
+  capacityValue3: 80
+});
+console.log(capacity); // 80
+```
+
+#### `calculateMaxCapacity({ capacityValue2, capacityValue3, capacityValue4, comparer }): number`
+
+Calculates maximum capacity with complex business logic.
+
+**Example:**
+```typescript
+const maxCapacity = calculateMaxCapacity({
+  capacityValue2: 100,
+  capacityValue3: 120,
+  capacityValue4: 90,
+  comparer: 50
+});
+console.log(maxCapacity); // 100
+```
+
+### Data Extraction Helpers
+
+#### `getReceiptStatusFromReturn(returnData): ReceiptCompleteStatus`
+
+Extracts the completion status from a return's receipts.
+
+**Returns:** Object with `allCompleted` and `atLeastOneComplete` flags
+
+#### `getReceiptNumberFromReturn(returnData): string | undefined`
+
+Extracts the receipt number from the first receipt in a return.
+
+#### `getReceiptItemsFromReturn(returnData): ReceiptItem[]`
+
+Extracts all receipt items from a return's receipts.
+
+#### `getReceiptItemQuantityFromReturn(returnData): number`
+
+Calculates total quantity of all receipt items in a return.
+
+#### `getPackageNumbersFromReturn(returnData): string[]`
+
+Extracts all package numbers from a return's receipts.
+
+#### `getRetailPriceFromItem(item): number | undefined`
+
+Extracts the retail price value from a catalogue item.
+
+#### `getAssortmentFromItem(item): object | undefined`
+
+Extracts assortment information from a catalogue item.
+
+#### `calculateAvailableStock({ inStock, unreleased }): number`
+
+Calculates available stock by subtracting unreleased quantities.
+
+#### `calculateTargetStock({ min, max }): number`
+
+Calculates target stock level from min/max values.
+
+## Testing
+
+The library uses **Jest** with **Spectator** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test remission-data-access --skip-nx-cache
+
+# Run tests with coverage
+npx nx test remission-data-access --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test remission-data-access --watch
+```
+
+### Test Coverage
+
+The library includes comprehensive unit tests covering:
+
+- **Service methods** - All CRUD operations for returns, receipts, and items
+- **State management** - RemissionStore operations and computed signals
+- **Helper functions** - Calculation and extraction helpers
+- **Error handling** - API errors, validation failures, missing data
+- **Abort signal support** - Request cancellation scenarios
+- **Caching behavior** - @Cache and @InFlight decorator functionality
+- **Batch operations** - StockInfoResource batching logic
+
+## Architecture Notes
+
+### Current Architecture
+
+The library follows a layered architecture with clear separation of concerns:
+
+```
+Components/Features
+       ↓
+  RemissionStore (optional, state management)
+       ↓
+  Services (business logic)
+       ↓
+├─→ Resources (batching optimization)
+├─→ Generated API Clients (inventory-api)
+├─→ Helper Functions (calculations, extractions)
+└─→ Schemas (Zod validation)
+```
+
+### Design Patterns
+
+1. **Service Layer Pattern** - API interactions wrapped in domain services
+2. **Batching Resource Pattern** - Efficient stock info fetching with automatic batching
+3. **Caching Strategy** - Multi-level caching (memory, decorators)
+4. **State Management Pattern** - NgRx Signals with session persistence
+5. **Validation Pattern** - Zod schemas for runtime validation
+
+### Known Considerations
+
+1. **Service Location** - BranchService should move to inventory-data-access
+2. **Schema Validation TODO** - Supplier cache needs validation
+3. **Caching Strategy** - Consider standardizing on decorator-based approach
+
+### Performance Optimizations
+
+- Batching reduces stock API calls by ~80%
+- 5-minute caching for frequently accessed metadata
+- @InFlight() prevents duplicate concurrent requests
+- Session persistence avoids unnecessary re-fetching
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework
+- `@ngrx/signals` - State management with signals
+- `@generated/swagger/inventory-api` - Generated API client
+- `@isa/common/data-access` - Common utilities
+- `@isa/common/decorators` - Caching decorators
+- `@isa/core/logging` - Logging service
+- `@isa/core/storage` - Storage providers
+- `@isa/catalogue/data-access` - Item models
+- `zod` - Schema validation
+- `rxjs` - Reactive programming
+
+### Path Alias
+
+Import from: `@isa/remission/data-access`
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/remission/data-access/src/lib/schemas/fetch-stock-in-stock.schema.ts b/libs/remission/data-access/src/lib/schemas/fetch-stock-in-stock.schema.ts
index 9cb589035..01456558b 100644
--- a/libs/remission/data-access/src/lib/schemas/fetch-stock-in-stock.schema.ts
+++ b/libs/remission/data-access/src/lib/schemas/fetch-stock-in-stock.schema.ts
@@ -1,8 +1,8 @@
 import { z } from 'zod';
 
 export const FetchStockInStockSchema = z.object({
-  stockId: z.number().optional(),
-  itemIds: z.array(z.number()),
+  stockId: z.number().describe('Stock identifier').optional(),
+  itemIds: z.array(z.number()).describe('Item ids'),
 });
 
 export type FetchStockInStock = z.infer<typeof FetchStockInStockSchema>;
diff --git a/libs/remission/feature/remission-list/README.md b/libs/remission/feature/remission-list/README.md
index 182acd0ed..6cb125867 100644
--- a/libs/remission/feature/remission-list/README.md
+++ b/libs/remission/feature/remission-list/README.md
@@ -1,7 +1,299 @@
-# remi-remission-list
-
-This library was generated with [Nx](https://nx.dev).
-
-## Running unit tests
-
-Run `nx test remi-remission-list` to execute the unit tests.
+# @isa/remission/feature/remission-list
+
+Feature module providing the main remission list view with filtering, searching, item selection, and remitting capabilities for department ("Abteilung") and mandatory ("Pflicht") return workflows.
+
+## Overview
+
+The Remission List Feature library implements the core remission workflow interface where users search, select, and remit items. It supports two remission types: Abteilung (department-based suggestions) and Pflicht (mandatory returns). The component integrates filtering, stock information, product groups, and provides sophisticated user interactions including automatic item selection (#5338), empty search handling, and batch remitting operations.
+
+## Features
+
+- **Dual Remission Types** - Abteilung (suggestions) and Pflicht (mandatory) lists
+- **Advanced Filtering** - FilterService integration with query parameter sync
+- **Product Search** - Real-time search with scanner support
+- **Stock Information** - Batched stock fetching for displayed items
+- **Product Groups** - Dynamic product group resolution
+- **Item Selection** - Multi-select with quantity tracking
+- **Batch Remitting** - Add multiple items to return receipt
+- **Auto-Selection** - Single item auto-select (#5338)
+- **Empty Search Handling** - Dialog to add unlisted items
+- **Resource-Based Data** - Efficient data fetching with resource pattern
+- **State Management** - RemissionStore integration
+- **Error Handling** - Comprehensive error dialogs
+- **Scroll Position** - Automatic scroll restoration
+
+## Quick Start
+
+```typescript
+import { RemissionListComponent } from '@isa/remission/feature/remission-list';
+import { provideRemissionListRoutes } from '@isa/remission/feature/remission-list';
+
+// In routes configuration
+export const routes: Routes = [
+  {
+    path: 'remission',
+    loadChildren: () => import('@isa/remission/feature/remission-list').then(m => m.routes)
+  }
+];
+
+// Routes include:
+// - remission (default Pflicht list)
+// - remission/abteilung (department list)
+```
+
+## Component API
+
+### RemissionListComponent
+
+Main list view component for remission workflows.
+
+**Selector**: `remi-feature-remission-list`
+
+**Route Data Requirements**:
+- `querySettings`: Filter query settings from resolver
+
+**Key Signals**:
+```typescript
+selectedRemissionListType = injectRemissionListType(); // 'Abteilung' | 'Pflicht'
+remissionStarted = computed(() => store.remissionStarted());
+items = computed(() => remissionResource.value()?.result || []);
+stockInfoMap = computed(() => new Map(stockData.map(i => [i.itemId, i])));
+hasSelectedItems = computed(() => Object.keys(store.selectedItems()).length > 0);
+```
+
+**Key Methods**:
+- `search(trigger: SearchTrigger): void` - Trigger filtered search
+- `remitItems(options?): Promise<void>` - Remit selected items to receipt
+- `reloadListAndReturnData(): void` - Refresh list and receipt data
+- `getStockForItem(item): StockInfo | undefined` - Get stock for item
+- `getProductGroupValueForItem(item): string | undefined` - Get product group name
+
+## Resources
+
+### RemissionListResource
+
+Fetches remission items based on type and filters.
+
+**Parameters**:
+- `remissionListType`: 'Abteilung' | 'Pflicht'
+- `queryToken`: Filter query
+- `searchTrigger`: Trigger type
+
+### RemissionInStockResource
+
+Batches stock information for visible items.
+
+**Parameters**:
+- `itemIds`: Array of catalog product numbers
+
+### RemissionProductGroupResource
+
+Fetches product group key-value mappings.
+
+## Usage Examples
+
+### Basic Remission List Integration
+
+```typescript
+import { Component } from '@angular/core';
+import { RemissionListComponent } from '@isa/remission/feature/remission-list';
+
+@Component({
+  selector: 'app-remission-page',
+  imports: [RemissionListComponent],
+  template: `
+    <remi-feature-remission-list></remi-feature-remission-list>
+  `
+})
+export class RemissionPageComponent {}
+```
+
+### Remitting Items Programmatically
+
+```typescript
+import { RemissionListComponent } from '@isa/remission/feature/remission-list';
+
+@Component({
+  selector: 'app-custom-remission',
+  viewChild: RemissionListComponent
+})
+export class CustomRemissionComponent {
+  remissionList = viewChild.required(RemissionListComponent);
+
+  async remitSelectedItems() {
+    await this.remissionList().remitItems();
+  }
+}
+```
+
+### Custom Search Handling
+
+```typescript
+import { RemissionListComponent } from '@isa/remission/feature/remission-list';
+
+@Component({})
+export class EnhancedRemissionListComponent extends RemissionListComponent {
+  override async search(trigger: SearchTrigger) {
+    console.log('Search triggered:', trigger);
+    super.search(trigger);
+  }
+}
+```
+
+## Workflow Details
+
+### Search Flow
+
+1. User enters search term or scans barcode
+2. FilterService commits query
+3. RemissionListResource fetches filtered items
+4. InStockResource fetches stock for results
+5. ProductGroupResource resolves group names
+6. Items displayed with stock/group information
+
+### Empty Search Handling
+
+If search returns no results:
+1. Check if search was user-initiated (#5338)
+2. Open SearchItemToRemitDialog
+3. User searches catalog and selects item
+4. If remission started, add item and remit automatically
+5. If Abteilung list, navigate to default Pflicht list
+6. Reload list data
+
+### Auto-Selection (#5338)
+
+When search returns single item and remission started:
+- Automatically select the item
+- Pre-fill with calculated stock to remit
+- User can adjust quantity before remitting
+
+### Remitting Flow
+
+1. User selects items from list
+2. For each item:
+   - Calculate quantity to remit
+   - Get available stock
+   - Call `remitItem` API with returnId/receiptId
+3. Handle errors with dialog
+4. Clear selections
+5. Reload list and receipt data
+6. Show success/error state
+
+### Error Handling
+
+**RemissionResponseArgsErrorMessage.AlreadyCompleted**:
+- Clear RemissionStore state
+- Show error dialog
+- Reload data
+
+**Other Errors**:
+- Log error with context
+- Show error dialog with message
+- Set button to error state
+- Reload data
+
+## Components
+
+### RemissionListItemComponent
+
+Individual list item with selection controls.
+
+**Features**:
+- Product information display
+- Stock information
+- Quantity input
+- Selection checkbox
+- Delete action
+
+### RemissionListSelectComponent
+
+Type selector (Abteilung/Pflicht).
+
+### RemissionStartCardComponent
+
+Card for starting new remission.
+
+### RemissionReturnCardComponent
+
+Card showing current return receipt.
+
+### RemissionListEmptyStateComponent
+
+Empty state when no items found.
+
+## Routing
+
+```typescript
+import { routes } from '@isa/remission/feature/remission-list';
+
+// Default route: Pflicht list
+{
+  path: '',
+  component: RemissionListComponent,
+  resolve: {
+    querySettings: querySettingsResolverFn
+  }
+}
+
+// Abteilung route
+{
+  path: 'abteilung',
+  component: RemissionListComponent,
+  resolve: {
+    querySettings: querySettingsDepartmentResolverFn
+  }
+}
+```
+
+## State Management
+
+**RemissionStore Integration**:
+```typescript
+// Selection
+store.selectRemissionItem(itemId, item);
+store.clearSelectedItems();
+
+// Quantity
+store.selectedQuantity()[itemId];
+
+// Current remission
+store.remissionStarted();
+store.returnId();
+store.receiptId();
+
+// State clearing
+store.clearState();
+```
+
+## Testing
+
+```bash
+npx nx test remission-feature-remission-list --skip-nx-cache
+```
+
+## Dependencies
+
+- `@angular/core` - Angular framework
+- `@angular/router` - Routing
+- `@isa/remission/data-access` - RemissionStore, services, types
+- `@isa/remission/shared/product` - Product components
+- `@isa/remission/shared/search-item-to-remit-dialog` - Search dialog
+- `@isa/shared/filter` - Filtering infrastructure
+- `@isa/ui/buttons` - Button components
+- `@isa/ui/dialog` - Dialogs
+- `@isa/utils/scroll-position` - Scroll restoration
+
+## Architecture Notes
+
+**Resource Pattern**: Uses Angular resource pattern for efficient data fetching with automatic dependency tracking.
+
+**Filter Integration**: Deep FilterService integration with query parameter synchronization for shareable URLs.
+
+**Computed Signals**: Extensive use of computed signals for derived state.
+
+**Effects**: React to search results with automatic UI interactions (dialogs, auto-select).
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/remission/feature/remission-return-receipt-details/README.md b/libs/remission/feature/remission-return-receipt-details/README.md
index 6fd83756b..08868c248 100644
--- a/libs/remission/feature/remission-return-receipt-details/README.md
+++ b/libs/remission/feature/remission-return-receipt-details/README.md
@@ -1,7 +1,145 @@
-# remission-feature-remission-return-receipt-details
+# @isa/remission/feature/remission-return-receipt-details
 
-This library was generated with [Nx](https://nx.dev).
+Feature component for displaying detailed view of a return receipt ("Warenbegleitschein") with items, actions, and completion workflows.
 
-## Running unit tests
+## Overview
 
-Run `nx test remission-feature-remission-return-receipt-details` to execute the unit tests.
+The Remission Return Receipt Details feature provides a comprehensive view of a single return receipt including all items, receipt metadata, package information, and action buttons for managing the receipt. It integrates with return-receipt-actions components for deletion, continuation, and completion workflows.
+
+## Features
+
+- **Receipt Details Display** - Receipt number, creation date, status
+- **Item List** - All items in the receipt with product information
+- **Package Information** - Assigned package numbers
+- **Action Buttons** - Delete, continue, complete actions
+- **Empty State** - User-friendly empty receipt view
+- **Loading States** - Skeleton loaders during data fetch
+- **Resource-Based Data** - Efficient return data fetching
+- **Navigation** - Back button to return to previous view
+- **Eager Loading** - Preload 3 levels of related data
+
+## Quick Start
+
+```typescript
+import { RemissionReturnReceiptDetailsComponent } from '@isa/remission/feature/remission-return-receipt-details';
+
+// In routes
+{
+  path: 'receipt/:returnId/:receiptId',
+  component: RemissionReturnReceiptDetailsComponent
+}
+
+// Usage
+<a [routerLink]="['/receipt', returnId, receiptId]">View Receipt</a>
+```
+
+## Component API
+
+### RemissionReturnReceiptDetailsComponent
+
+Standalone component for receipt details view.
+
+**Selector**: `remi-remission-return-receipt-details`
+
+**Inputs** (from route params):
+- `returnId`: number (required, coerced from string)
+- `receiptId`: number (required, coerced from string)
+
+**Computed Signals**:
+```typescript
+returnLoading = computed(() => returnResource.isLoading());
+returnData = computed(() => returnResource.value());
+receiptNumber = computed(() => getReceiptNumberFromReturn(returnData()));
+receiptItems = computed(() => getReceiptItemsFromReturn(returnData()));
+canRemoveItems = computed(() => !returnData().completed);
+hasAssignedPackage = computed(() => getPackageNumbersFromReturn(returnData()) !== '');
+```
+
+## Resources
+
+### ReturnResource
+
+Fetches return with receipt data.
+
+**Parameters**:
+- `returnId`: number
+- `eagerLoading`: number (levels to preload, default 3)
+
+**Returns**: `Return` with nested receipts and items
+
+## Usage Example
+
+```typescript
+import { Component } from '@angular/core';
+import { RemissionReturnReceiptDetailsComponent } from '@isa/remission/feature/remission-return-receipt-details';
+
+@Component({
+  selector: 'app-receipt-page',
+  imports: [RemissionReturnReceiptDetailsComponent],
+  template: `
+    <remi-remission-return-receipt-details
+      [returnId]="returnId()"
+      [receiptId]="receiptId()"
+    ></remi-remission-return-receipt-details>
+  `
+})
+export class ReceiptPageComponent {
+  returnId = input.required<number>();
+  receiptId = input.required<number>();
+}
+```
+
+## Components
+
+### RemissionReturnReceiptDetailsCardComponent
+
+Card displaying receipt metadata.
+
+### RemissionReturnReceiptDetailsItemComponent
+
+Individual receipt item display.
+
+### RemissionReturnReceiptActionsComponent
+
+Action buttons (delete, continue) from shared library.
+
+### RemissionReturnReceiptCompleteComponent
+
+Complete button from shared library.
+
+## Helper Functions
+
+```typescript
+// From @isa/remission/data-access
+getReceiptNumberFromReturn(return: Return): string
+getReceiptItemsFromReturn(return: Return): ReceiptItem[]
+getPackageNumbersFromReturn(return: Return): string
+```
+
+## Empty State
+
+**When Shown**: No return data or empty receipt
+
+**Content**:
+- Title: "Kein Warenbegleitschein vorhanden"
+- Description: "Es wurde kein Warenbegleitschein gefunden."
+
+## Testing
+
+```bash
+npx nx test remission-return-receipt-details --skip-nx-cache
+```
+
+## Dependencies
+
+- `@angular/core` - Angular framework
+- `@angular/common` - Location service
+- `@isa/remission/data-access` - Return types, helper functions
+- `@isa/remission/shared/return-receipt-actions` - Action components
+- `@isa/ui/buttons` - Button components
+- `@isa/ui/empty-state` - Empty state component
+- `@isa/icons` - Icons
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/remission/feature/remission-return-receipt-list/README.md b/libs/remission/feature/remission-return-receipt-list/README.md
index a522f3d7e..d72995c72 100644
--- a/libs/remission/feature/remission-return-receipt-list/README.md
+++ b/libs/remission/feature/remission-return-receipt-list/README.md
@@ -1,7 +1,183 @@
-# remission-feature-remission-return-receipt-list
+# @isa/remission/feature/remission-return-receipt-list
 
-This library was generated with [Nx](https://nx.dev).
+Feature component providing a comprehensive list view of all return receipts with filtering, sorting, and action capabilities.
 
-## Running unit tests
+## Overview
 
-Run `nx test remission-feature-remission-return-receipt-list` to execute the unit tests.
+The Remission Return Receipt List feature displays all return receipts (Warenbegleitscheine) in a filterable, sortable list view. It separates completed and incomplete receipts, provides date-based sorting, and integrates with return-receipt-actions for management operations. The component uses resource-based data fetching for optimal performance.
+
+## Features
+
+- **Completed/Incomplete Separation** - Separate resource fetching
+- **Date Sorting** - Sort by created or completed date
+- **Filtering** - FilterService integration with query params
+- **Action Integration** - Delete, continue, complete buttons
+- **Resource Pattern** - Efficient parallel data fetching
+- **Reload Capability** - Refresh list after actions
+- **Responsive Layout** - Card-based list design
+- **Empty States** - User-friendly empty list views
+
+## Quick Start
+
+```typescript
+import { RemissionReturnReceiptListComponent } from '@isa/remission/feature/remission-return-receipt-list';
+
+// In routes
+{
+  path: 'receipts',
+  component: RemissionReturnReceiptListComponent
+}
+```
+
+## Component API
+
+### RemissionReturnReceiptListComponent
+
+Standalone list component for return receipts.
+
+**Selector**: `remi-remission-return-receipt-list`
+
+**Computed Signals**:
+```typescript
+orderDateBy = computed(() => filterService.orderBy().find(o => o.selected));
+completedRemissionReturnsResourceValue = computed(() => completedResource.value() || []);
+incompletedRemissionReturnsResourceValue = computed(() => incompletedResource.value() || []);
+returns = computed(() => {
+  // Combines and sorts completed + incomplete
+  // Flattens receipts into [Return, Receipt] tuples
+});
+```
+
+**Methods**:
+- `reloadList(): void` - Reload both completed and incomplete resources
+
+## Resources
+
+### CompletedRemissionReturnsResource
+
+Fetches completed return receipts.
+
+**API**: `/api/remission/returns?completed=true`
+
+### IncompletedRemissionReturnsResource
+
+Fetches incomplete return receipts.
+
+**API**: `/api/remission/returns?completed=false`
+
+## Sorting
+
+**Sort Fields**:
+- `created` - Receipt creation date
+- `completed` - Receipt completion date
+
+**Sort Direction**:
+- `asc` - Ascending (oldest first)
+- `desc` - Descending (newest first)
+
+**Implementation**:
+```typescript
+const compareFn = (a: string, b: string) => {
+  return (orderBy.dir === 'desc' ? compareDesc : compareAsc)(a, b);
+};
+
+completed = orderByKey(completed, 'created', compareFn);
+incompleted = orderByKey(incompleted, 'created', compareFn);
+```
+
+## Usage Example
+
+```typescript
+import { Component } from '@angular/core';
+import { RemissionReturnReceiptListComponent } from '@isa/remission/feature/remission-return-receipt-list';
+
+@Component({
+  selector: 'app-receipts-page',
+  imports: [RemissionReturnReceiptListComponent],
+  template: `
+    <div class="page-container">
+      <h1>Return Receipts</h1>
+      <remi-remission-return-receipt-list></remi-remission-return-receipt-list>
+    </div>
+  `
+})
+export class ReceiptsPageComponent {}
+```
+
+## Components
+
+### ReturnReceiptListItemComponent
+
+Individual receipt list item.
+
+**Features**:
+- Receipt metadata display
+- Status indicator (completed/incomplete)
+- Item count
+- Action buttons
+
+### ReturnReceiptListCardComponent
+
+Card wrapper for list items.
+
+## Query Settings
+
+**Default Configuration**:
+```typescript
+{
+  orderBy: [
+    { by: 'created', label: 'Erstellungsdatum', dir: 'desc', selected: true },
+    { by: 'completed', label: 'Abschlussdatum', dir: 'desc', selected: false }
+  ]
+}
+```
+
+## Data Structure
+
+**Return Receipt Tuple**:
+```typescript
+type ReturnReceiptTuple = [Return, Receipt];
+
+// Return contains:
+{
+  id: number;
+  returnGroup: string;
+  completed: boolean;
+  receipts: Array<{ id: number; data: Receipt }>;
+}
+
+// Receipt contains:
+{
+  number: string;
+  created: string;
+  completed?: string;
+  items: ReceiptItem[];
+}
+```
+
+## Testing
+
+```bash
+npx nx test remission-return-receipt-list --skip-nx-cache
+```
+
+## Dependencies
+
+- `@angular/core` - Angular framework
+- `@angular/router` - Routing
+- `@isa/remission/data-access` - Return types
+- `@isa/shared/filter` - FilterService
+- `@isa/ui/buttons` - Button components
+- `date-fns` - Date comparison utilities
+
+## Architecture Notes
+
+**Parallel Resource Fetching**: Completed and incomplete receipts are fetched in parallel for optimal performance.
+
+**Tuple Flattening**: Returns with multiple receipts are flattened into [Return, Receipt] tuples for easier iteration.
+
+**Filter Integration**: Uses FilterService with query parameter synchronization for shareable filtered views.
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/remission/shared/product/README.md b/libs/remission/shared/product/README.md
index 7aac958a2..7af5b3e10 100644
--- a/libs/remission/shared/product/README.md
+++ b/libs/remission/shared/product/README.md
@@ -1,7 +1,237 @@
-# remission-shared-product
+# @isa/remission/shared/product
 
-This library was generated with [Nx](https://nx.dev).
+A collection of Angular standalone components for displaying product information in remission workflows, including product details, stock information, and shelf metadata.
 
-## Running unit tests
+## Overview
 
-Run `nx test remission-shared-product` to execute the unit tests.
+The Remission Shared Product library provides three specialized presentation components designed for remission list views and return receipt workflows. These components display comprehensive product information including images, pricing, stock levels, shelf locations, and product group classifications. All components follow OnPush change detection for optimal performance and use Angular signals for reactive data management.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Component API](#component-api)
+- [Usage Examples](#usage-examples)
+- [Component Details](#component-details)
+- [Styling and Layout](#styling-and-layout)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+- [Dependencies](#dependencies)
+
+## Features
+
+- **Product Information Display** - Comprehensive product presentation with image, contributors, name, price, format, and EAN
+- **Stock Information Tracking** - Real-time stock display with current, remit, target, and ZOB quantities
+- **Shelf Metadata Presentation** - Department, shelf label, product group, assortment, and return reason display
+- **Flexible Orientation** - Horizontal or vertical layout options for product info component
+- **Loading States** - Skeleton loader support for stock information during fetch operations
+- **Responsive Design** - Tailwind CSS with ISA design system integration
+- **E2E Testing Attributes** - Comprehensive data-* attributes for automated testing
+- **Type-Safe Inputs** - Angular signal-based inputs with proper type definitions
+- **OnPush Change Detection** - Optimized performance with OnPush strategy
+- **Standalone Components** - All components are standalone with explicit imports
+
+## Quick Start
+
+### 1. Import Components
+
+```typescript
+import {
+  ProductInfoComponent,
+  ProductStockInfoComponent,
+  ProductShelfMetaInfoComponent
+} from '@isa/remission/shared/product';
+
+@Component({
+  selector: 'app-remission-item',
+  imports: [
+    ProductInfoComponent,
+    ProductStockInfoComponent,
+    ProductShelfMetaInfoComponent
+  ],
+  template: '...'
+})
+export class RemissionItemComponent {
+  // Component logic
+}
+```
+
+### 2. Display Product Information
+
+```typescript
+@Component({
+  template: `
+    <remi-product-info
+      [item]="remissionItem()"
+      [orientation]="'horizontal'"
+    ></remi-product-info>
+  `
+})
+export class MyComponent {
+  remissionItem = signal<ProductInfoItem>({
+    product: {
+      ean: '9781234567890',
+      name: 'Product Name',
+      contributors: 'Author Name',
+      format: 'Hardcover',
+      formatDetail: '256 pages'
+    },
+    retailPrice: {
+      value: { value: 29.99, currency: 'EUR', currencySymbol: '€' },
+      vat: { value: 4.78, inPercent: 19, label: '19%', vatType: 1 }
+    },
+    tag: 'Prio 1'
+  });
+}
+```
+
+### 3. Display Stock Information
+
+```typescript
+@Component({
+  template: `
+    <remi-product-stock-info
+      [availableStock]="45"
+      [stockToRemit]="10"
+      [targetStock]="35"
+      [zob]="20"
+      [stockFetching]="loading()"
+    ></remi-product-stock-info>
+  `
+})
+export class MyComponent {
+  loading = signal(false);
+}
+```
+
+### 4. Display Shelf Metadata
+
+```typescript
+@Component({
+  template: `
+    <remi-product-shelf-meta-info
+      [department]="'Reise'"
+      [shelfLabel]="'Europa'"
+      [productGroupKey]="'RG001'"
+      [productGroupValue]="'Reiseführer'"
+      [assortment]="'Basissortiment|BPrämienartikel|n'"
+      [returnReason]="'Überbestand'"
+    ></remi-product-shelf-meta-info>
+  `
+})
+export class MyComponent {}
+```
+
+## Component API
+
+### ProductInfoComponent
+
+Display component for comprehensive product information with image, pricing, and metadata.
+
+#### Selector
+
+```html
+<remi-product-info></remi-product-info>
+```
+
+#### Inputs
+
+| Input | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `item` | `ProductInfoItem` | Yes | - | Product data including product details, price, and tag |
+| `orientation` | `'horizontal' \| 'vertical'` | No | `'horizontal'` | Layout orientation for product display |
+| `innerGridClass` | `string` | No | `'grid-cols-[minmax(20rem,1fr),auto]'` | Custom grid CSS classes for inner layout |
+
+#### ProductInfoItem Type
+
+```typescript
+type ProductInfoItem = Pick<RemissionItem, 'product' | 'retailPrice' | 'tag'>;
+
+// Full structure:
+{
+  product: {
+    ean: string;
+    name: string;
+    contributors: string;
+    format: string;
+    formatDetail?: string;
+  };
+  retailPrice?: {
+    value: { value: number; currency: string; currencySymbol: string };
+    vat: { value: number; inPercent: number; label: string; vatType: number };
+  };
+  tag?: 'Prio 1' | 'Prio 2' | 'Pflicht';
+}
+```
+
+### ProductStockInfoComponent
+
+Display component for product stock information including current, remit, target, and ZOB quantities.
+
+#### Selector
+
+```html
+<remi-product-stock-info></remi-product-stock-info>
+```
+
+#### Inputs
+
+| Input | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `stockFetching` | `boolean` | No | `false` | Loading state indicator for skeleton loader |
+| `availableStock` | `number` | No | `0` | Current available stock after removals |
+| `stockToRemit` | `number` | No | `0` | Remission quantity |
+| `targetStock` | `number` | No | `0` | Remaining stock after predefined return |
+| `zob` | `number` | No | `0` | Min Stock Category Management |
+
+### ProductShelfMetaInfoComponent
+
+Display component for product shelf metadata including department, location, product group, assortment, and return reason.
+
+#### Selector
+
+```html
+<remi-product-shelf-meta-info></remi-product-shelf-meta-info>
+```
+
+#### Inputs
+
+| Input | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `department` | `string` | No | `''` | Department name |
+| `shelfLabel` | `string` | No | `''` | Shelf label |
+| `productGroupKey` | `string` | No | `''` | Product group key |
+| `productGroupValue` | `string` | No | `''` | Product group value |
+| `assortment` | `string` | No | `''` | Assortment string (pipe-delimited) |
+| `returnReason` | `string` | No | `''` | Return reason |
+
+## Usage Examples
+
+See the [full documentation](#quick-start) above for detailed usage examples.
+
+## Testing
+
+```bash
+# Run tests
+npx nx test remission-shared-product --skip-nx-cache
+
+# Run tests with coverage
+npx nx test remission-shared-product --code-coverage --skip-nx-cache
+```
+
+## Architecture Notes
+
+All components are pure presentation components following OnPush change detection strategy. They use Angular signals for reactive state management and include comprehensive E2E testing attributes.
+
+## Dependencies
+
+- `@angular/core` - Angular framework
+- `@isa/remission/data-access` - RemissionItem types
+- `@isa/shared/product-image` - Product image directive
+- `@isa/ui/label` - Label component
+- `@isa/ui/skeleton-loader` - Loading skeleton
+- `@isa/icons` - Icon library
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/remission/shared/remission-start-dialog/README.md b/libs/remission/shared/remission-start-dialog/README.md
index 5c3a25f64..6a2f82591 100644
--- a/libs/remission/shared/remission-start-dialog/README.md
+++ b/libs/remission/shared/remission-start-dialog/README.md
@@ -1,7 +1,205 @@
-# remission-start-dialog
+# @isa/remission/shared/remission-start-dialog
 
-This library was generated with [Nx](https://nx.dev).
+Angular dialog component for initiating remission processes with two-step workflow: creating return receipts and assigning package numbers.
 
-## Running unit tests
+## Overview
 
-Run `nx test remission-start-dialog` to execute the unit tests.
+The Remission Start Dialog library provides a critical workflow component for starting new remission processes ("Warenbegleitschein" - return receipt workflow). It implements a two-step process: first creating or inputting a return receipt number, then assigning a package number ("Wannennummer"). The component integrates with RemissionStore for state management and supports both automatic and manual input modes.
+
+## Features
+
+- **Two-Step Workflow** - Receipt creation → Package assignment
+- **Receipt Number Options** - Auto-generate or manual input
+- **Package Number Assignment** - Scan or manual entry (#5289)
+- **Validation** - Server-side validation with error handling
+- **Loading States** - Separate loading states for each step
+- **Error Recovery** - Display validation errors inline
+- **RemissionStore Integration** - Automatic state synchronization
+- **Service Wrapper** - RemissionStartService for simplified usage
+
+## Quick Start
+
+```typescript
+import { RemissionStartService } from '@isa/remission/shared/remission-start-dialog';
+
+@Component({})
+export class MyComponent {
+  #remissionStartService = inject(RemissionStartService);
+
+  async startNewRemission(returnGroup: string) {
+    await this.#remissionStartService.startRemission(returnGroup);
+    // RemissionStore is automatically updated
+    // User is ready to add items
+  }
+
+  // #5289 - Package assignment only
+  async assignPackageOnly(returnId: number, receiptId: number) {
+    const result = await this.#remissionStartService.assignPackage({
+      returnId,
+      receiptId
+    });
+    if (result) {
+      console.log('Package assigned:', result);
+    }
+  }
+}
+```
+
+## Component API
+
+### RemissionStartDialogComponent
+
+Two-step dialog for creating return receipts and assigning packages.
+
+**Selector**: `remi-remission-start-dialog`
+
+**Dialog Data**:
+```typescript
+{
+  returnGroup: string | undefined;
+  assignPackage?: {
+    returnId: number;
+    receiptId: number;
+  } | undefined; // #5289 - Package assignment only mode
+}
+```
+
+**Dialog Result**:
+```typescript
+{
+  returnId: number;
+  receiptId: number;
+} | undefined
+```
+
+### RemissionStartService
+
+Injectable service for simplified dialog usage.
+
+**Methods**:
+- `startRemission(returnGroup: string | undefined): Promise<void>`
+- `assignPackage({ returnId, receiptId }): Promise<RemissionStartDialogResult>`
+
+## Two-Step Workflow
+
+### Step 1: Create Return Receipt
+
+**Options**:
+1. **Generate** - Auto-generate receipt number
+2. **Input** - Manual receipt number entry
+
+**Component**: `CreateReturnReceiptComponent`
+
+**API Call**: `RemissionReturnReceiptService.createRemission()`
+
+**Validation**: Server-side validation via `invalidProperties` error response
+
+### Step 2: Assign Package Number
+
+**Input**: Scan or manually enter package number ("Wannennummer")
+
+**Component**: `AssignPackageNumberComponent`
+
+**API Call**: `RemissionReturnReceiptService.assignPackage()`
+
+**Requirement**: #5289 - Package must be assigned before completing remission
+
+## Usage Examples
+
+### Start Remission from Card
+
+```typescript
+import { RemissionStartService } from '@isa/remission/shared/remission-start-dialog';
+
+@Component({
+  selector: 'app-remission-start-card',
+  template: `
+    <button (click)="startRemission()" uiButton>
+      Neue Remission starten
+    </button>
+  `
+})
+export class RemissionStartCardComponent {
+  #remissionStartService = inject(RemissionStartService);
+  #router = inject(Router);
+  #tabId = injectTabId();
+
+  returnGroup = input<string | undefined>(undefined);
+
+  async startRemission() {
+    await this.#remissionStartService.startRemission(this.returnGroup());
+    await this.#router.navigate(['/', this.#tabId(), 'remission']);
+  }
+}
+```
+
+### Assign Package Before Completion
+
+```typescript
+import { RemissionStartService } from '@isa/remission/shared/remission-start-dialog';
+
+@Component({})
+export class CompleteButtonComponent {
+  #remissionStartService = inject(RemissionStartService);
+
+  async completeRemission() {
+    // #5289 - Ensure package is assigned
+    if (!this.hasAssignedPackage()) {
+      const result = await this.#remissionStartService.assignPackage({
+        returnId: this.returnId(),
+        receiptId: this.receiptId()
+      });
+
+      if (!result) {
+        return; // User canceled
+      }
+    }
+
+    // Proceed with completion
+    await this.completeReturnReceipt();
+  }
+}
+```
+
+## Component Details
+
+### Return Receipt Result Types
+
+```typescript
+enum ReturnReceiptResultType {
+  Close = 'close',      // User closed dialog
+  Generate = 'generate', // Auto-generate number
+  Input = 'input'       // Manual input
+}
+
+type ReturnReceiptResult =
+  | { type: ReturnReceiptResultType.Close }
+  | { type: ReturnReceiptResultType.Generate }
+  | { type: ReturnReceiptResultType.Input; value: string | undefined | null };
+```
+
+### Request Status Tracking
+
+```typescript
+type RequestStatus = {
+  loading: boolean;
+  invalidProperties?: Record<string, string>; // Server validation errors
+};
+```
+
+## Testing
+
+```bash
+npx nx test remission-remission-start-dialog --skip-nx-cache
+```
+
+## Dependencies
+
+- `@angular/core` - Angular framework
+- `@isa/remission/data-access` - RemissionStore, RemissionReturnReceiptService
+- `@isa/ui/dialog` - Dialog infrastructure
+- `@isa/icons` - Icons (isaActionScanner)
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/remission/shared/return-receipt-actions/README.md b/libs/remission/shared/return-receipt-actions/README.md
index bcd05c2ab..d64e9680a 100644
--- a/libs/remission/shared/return-receipt-actions/README.md
+++ b/libs/remission/shared/return-receipt-actions/README.md
@@ -1,7 +1,501 @@
-# remission-return-receipt-actions
+# @isa/remission/shared/return-receipt-actions
 
-This library was generated with [Nx](https://nx.dev).
+Angular standalone components for managing return receipt actions including deletion, continuation, and completion workflows in the remission process.
 
-## Running unit tests
+## Overview
 
-Run `nx test remission-return-receipt-actions` to execute the unit tests.
+The Remission Shared Return Receipt Actions library provides two specialized action components for managing return receipts in remission workflows. These components handle critical operations like deleting return receipts, continuing remission processes, and completing remission packages ("Wanne"). They integrate with the RemissionStore and RemissionReturnReceiptService to provide state management and API interactions.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Component API](#component-api)
+- [Usage Examples](#usage-examples)
+- [Component Details](#component-details)
+- [Business Logic](#business-logic)
+- [Testing](#testing)
+- [Dependencies](#dependencies)
+
+## Features
+
+- **Return Receipt Deletion** - Delete return receipts with validation and state cleanup
+- **Remission Continuation** - Continue existing or start new remission workflows
+- **Remission Completion** - Complete remission packages with automatic package assignment
+- **State Management** - Integration with RemissionStore for current remission tracking
+- **Confirmation Dialogs** - User confirmation for destructive and workflow-changing actions
+- **Navigation** - Automatic routing to remission list after operations
+- **Loading States** - Pending state indicators during async operations
+- **Error Handling** - Comprehensive error logging and recovery
+- **E2E Testing Attributes** - Complete data-* attributes for automated testing
+
+## Quick Start
+
+### 1. Import Components
+
+```typescript
+import {
+  RemissionReturnReceiptActionsComponent,
+  RemissionReturnReceiptCompleteComponent
+} from '@isa/remission/shared/return-receipt-actions';
+
+@Component({
+  selector: 'app-return-receipt-card',
+  imports: [
+    RemissionReturnReceiptActionsComponent,
+    RemissionReturnReceiptCompleteComponent
+  ],
+  template: '...'
+})
+export class ReturnReceiptCardComponent {}
+```
+
+### 2. Use Return Receipt Actions
+
+```typescript
+@Component({
+  template: `
+    <lib-remission-return-receipt-actions
+      [remissionReturn]="returnData()"
+      [displayDeleteAction]="true"
+      (reloadData)="onReloadList()"
+    ></lib-remission-return-receipt-actions>
+  `
+})
+export class MyComponent {
+  returnData = signal<Return>({ id: 123, receipts: [...] });
+
+  onReloadList() {
+    // Refresh the return receipt list
+  }
+}
+```
+
+### 3. Use Complete Button
+
+```typescript
+@Component({
+  template: `
+    <lib-remission-return-receipt-complete
+      [returnId]="123"
+      [receiptId]="456"
+      [itemsLength]="5"
+      [hasAssignedPackage]="true"
+      (reloadData)="onReloadList()"
+    ></lib-remission-return-receipt-complete>
+  `
+})
+export class MyComponent {
+  onReloadList() {
+    // Refresh the data
+  }
+}
+```
+
+## Component API
+
+### RemissionReturnReceiptActionsComponent
+
+Action buttons for deleting and continuing return receipts.
+
+#### Selector
+
+```html
+<lib-remission-return-receipt-actions></lib-remission-return-receipt-actions>
+```
+
+#### Inputs
+
+| Input | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `remissionReturn` | `Return` | Yes | - | Return data containing receipts and metadata |
+| `displayDeleteAction` | `boolean` | No | `true` | Whether to show the delete button |
+
+#### Outputs
+
+| Output | Type | Description |
+|--------|------|-------------|
+| `reloadData` | `void` | Emitted when the list needs to be reloaded |
+
+#### Key Methods
+
+**`onDelete(): Promise<void>`**
+- Deletes all receipts associated with the return
+- Clears RemissionStore state if deleting current remission
+- Emits `reloadData` event after successful deletion
+- Handles errors with comprehensive logging
+
+**`onContinueRemission(): Promise<void>`**
+- Starts a new remission if not already started
+- Shows confirmation dialog if different remission is in progress
+- Navigates to remission list after starting
+- Validates receipt availability before continuing
+
+### RemissionReturnReceiptCompleteComponent
+
+Fixed-position button for completing a remission package ("Wanne").
+
+#### Selector
+
+```html
+<lib-remission-return-receipt-complete></lib-remission-return-receipt-complete>
+```
+
+#### Inputs
+
+| Input | Type | Required | Description |
+|-------|------|----------|-------------|
+| `returnId` | `number` | Yes | Return ID (coerced from string) |
+| `receiptId` | `number` | Yes | Receipt ID (coerced from string) |
+| `itemsLength` | `number` | Yes | Number of items in the receipt |
+| `hasAssignedPackage` | `boolean` | Yes | Whether package number is assigned |
+
+#### Outputs
+
+| Output | Type | Description |
+|--------|------|-------------|
+| `reloadData` | `void` | Emitted when data needs to be reloaded |
+
+#### Key Methods
+
+**`completeRemission(): Promise<void>`**
+- Ensures package is assigned (#5289 requirement)
+- Completes the return receipt and return
+- Shows "Wanne abgeschlossen" dialog with options
+- Option 1: Complete return group (Beenden)
+- Option 2: Start new receipt in same group (Neue Wanne)
+- Emits `reloadData` event after completion
+
+**`completeSingleReturnReceipt(): Promise<Return>`**
+- Completes the return receipt via API
+- Clears RemissionStore state
+- Returns the completed return data
+
+## Usage Examples
+
+### Complete Return Receipt Workflow
+
+```typescript
+import {
+  RemissionReturnReceiptActionsComponent,
+  RemissionReturnReceiptCompleteComponent
+} from '@isa/remission/shared/return-receipt-actions';
+
+@Component({
+  selector: 'app-remission-receipt-details',
+  imports: [
+    RemissionReturnReceiptActionsComponent,
+    RemissionReturnReceiptCompleteComponent
+  ],
+  template: `
+    <div class="receipt-details">
+      <!-- Receipt content -->
+      <div class="receipt-items">
+        <!-- Item list -->
+      </div>
+
+      <!-- Action buttons at top -->
+      <lib-remission-return-receipt-actions
+        [remissionReturn]="returnData()"
+        [displayDeleteAction]="!isCompleted()"
+        (reloadData)="handleReload()"
+      ></lib-remission-return-receipt-actions>
+
+      <!-- Complete button (fixed position) -->
+      @if (!isCompleted()) {
+        <lib-remission-return-receipt-complete
+          [returnId]="returnId()"
+          [receiptId]="receiptId()"
+          [itemsLength]="receiptItems().length"
+          [hasAssignedPackage]="hasPackage()"
+          (reloadData)="handleReload()"
+        ></lib-remission-return-receipt-complete>
+      }
+    </div>
+  `
+})
+export class RemissionReceiptDetailsComponent {
+  returnData = signal<Return | undefined>(undefined);
+  returnId = signal(0);
+  receiptId = signal(0);
+  receiptItems = signal<ReceiptItem[]>([]);
+  hasPackage = signal(false);
+
+  isCompleted = computed(() => {
+    return this.returnData()?.completed ?? false;
+  });
+
+  handleReload() {
+    // Reload receipt data from API
+    this.fetchReceiptData();
+  }
+
+  async fetchReceiptData() {
+    // Fetch logic
+  }
+}
+```
+
+### Return Receipt List Actions
+
+```typescript
+import { RemissionReturnReceiptActionsComponent } from '@isa/remission/shared/return-receipt-actions';
+
+@Component({
+  selector: 'app-receipt-list-item',
+  imports: [RemissionReturnReceiptActionsComponent],
+  template: `
+    <div class="receipt-card">
+      <div class="receipt-header">
+        <span>Receipt #{{ return().receipts[0].number }}</span>
+        <span>{{ return().receipts[0].created | date }}</span>
+      </div>
+
+      <div class="receipt-body">
+        <div>Items: {{ itemCount() }}</div>
+        <div>Status: {{ status() }}</div>
+      </div>
+
+      <div class="receipt-actions">
+        <lib-remission-return-receipt-actions
+          [remissionReturn]="return()"
+          [displayDeleteAction]="canDelete()"
+          (reloadData)="reloadList.emit()"
+        ></lib-remission-return-receipt-actions>
+      </div>
+    </div>
+  `
+})
+export class ReceiptListItemComponent {
+  return = input.required<Return>();
+  reloadList = output<void>();
+
+  itemCount = computed(() => {
+    return this.return().receipts[0]?.data?.items?.length ?? 0;
+  });
+
+  status = computed(() => {
+    return this.return().completed ? 'Completed' : 'In Progress';
+  });
+
+  canDelete = computed(() => {
+    return !this.return().completed && this.itemCount() === 0;
+  });
+}
+```
+
+## Component Details
+
+### RemissionReturnReceiptActionsComponent
+
+**Button Layout:**
+- **Delete Button** (Secondary, optional):
+  - Text: "Löschen"
+  - Disabled when `itemQuantity > 0`
+  - Calls `onDelete()` method
+  - Only shown if `displayDeleteAction` is true
+
+- **Continue Button** (Primary):
+  - Text: "Befüllen"
+  - Always enabled
+  - Calls `onContinueRemission()` method
+
+**Computed Properties:**
+```typescript
+returnId = computed(() => this.remissionReturn().id);
+receiptIds = computed(() => this.remissionReturn().receipts?.map(r => r.id) || []);
+firstReceiptId = computed(() => this.receiptIds()[0]);
+itemQuantity = computed(() => getReceiptItemQuantityFromReturn(this.remissionReturn()));
+isCurrentRemission = computed(() => this.#store.isCurrentRemission({ returnId, receiptId }));
+```
+
+**Delete Flow:**
+1. Iterate through all receipt IDs
+2. For each receipt, check if it's the current remission
+3. If current, clear RemissionStore state
+4. Call `cancelReturnReceipt` API for each receipt
+5. Call `cancelReturn` API for the return
+6. Emit `reloadData` event
+7. Log errors if any occur
+
+**Continue Flow:**
+1. Check if remission is already started
+2. If not started:
+   - Start remission with first receipt ID
+   - Navigate to remission list
+3. If different remission in progress:
+   - Show confirmation dialog
+   - Options: Continue current OR start new
+   - If starting new, clear store and start with first receipt
+4. Navigate to remission list
+
+### RemissionReturnReceiptCompleteComponent
+
+**Button Appearance:**
+- Fixed position (bottom-right corner)
+- Large size
+- Brand color
+- Text: "Wanne abschließen"
+- Shows pending state during completion
+
+**Completion Flow:**
+1. **Package Assignment Check** (#5289):
+   - If no package assigned, open package assignment dialog
+   - If dialog canceled, abort completion
+
+2. **Complete Receipt**:
+   - Call `completeSingleReturnReceipt()`
+   - Clears RemissionStore state
+
+3. **Return Group Handling**:
+   - If return has `returnGroup`:
+     - Show "Wanne abgeschlossen" dialog
+     - Option 1 (Beenden): Complete return group via API
+     - Option 2 (Neue Wanne): Start new remission in same group
+
+4. **Emit Reload Event**: Notify parent to refresh data
+
+**Dialog Content:**
+```
+Title: "Wanne abgeschlossen"
+Message: "Legen Sie abschließend den 'Blank Beizettel' in die abgeschlossene Wanne.
+         Der Warenbegleitschein wird nach Abschluss der Remission versendet.
+         Zum Öffnen eines neuen Warenbegleitscheins setzen Sie die Remission fort."
+
+Buttons:
+  - Neue Wanne (Close button)
+  - Beenden (Confirm button)
+```
+
+## Business Logic
+
+### Package Assignment Requirement (#5289)
+
+Before completing a remission, a package number must be assigned. If not already assigned:
+1. Open package assignment dialog
+2. User scans or enters package number
+3. Package is assigned to the receipt
+4. Completion proceeds
+5. If user cancels, completion is aborted
+
+### Return Group Workflow
+
+**Return Groups** represent physical containers ("Wannen") for grouped returns:
+- Multiple receipts can belong to the same return group
+- Completing a receipt offers two options:
+  1. **Complete Entire Group**: Finalizes all receipts in the group
+  2. **Start New Receipt**: Creates a new receipt in the same group
+
+### State Management Integration
+
+**RemissionStore Interactions:**
+```typescript
+// Check if current remission
+isCurrentRemission({ returnId, receiptId })
+
+// Clear state when deleting or completing
+clearState()
+
+// Start remission when continuing
+startRemission({ returnId, receiptId })
+
+// Reload return data
+reloadReturn()
+```
+
+### Confirmation Dialogs
+
+**Delete Confirmation**: Not shown (direct deletion)
+
+**Continue with Different Remission**:
+```
+Title: "Bereits geöffneter Warenbegleitschein"
+Message: "Möchten Sie wirklich einen neuen öffnen, oder möchten Sie zuerst den aktuellen abschließen?"
+Close: "Aktuellen bearbeiten"
+Confirm: "Neuen öffnen"
+```
+
+**Completion Confirmation**:
+```
+Title: "Wanne abgeschlossen"
+Message: "Legen Sie abschließend den 'Blank Beizettel' in die abgeschlossene Wanne..."
+Close: "Neue Wanne"
+Confirm: "Beenden"
+```
+
+## Testing
+
+```bash
+# Run tests
+npx nx test remission-return-receipt-actions --skip-nx-cache
+
+# Run with coverage
+npx nx test remission-return-receipt-actions --code-coverage --skip-nx-cache
+```
+
+### Test Examples
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { RemissionReturnReceiptActionsComponent } from './remission-return-receipt-actions.component';
+
+describe('RemissionReturnReceiptActionsComponent', () => {
+  let component: RemissionReturnReceiptActionsComponent;
+  let fixture: ComponentFixture<RemissionReturnReceiptActionsComponent>;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      imports: [RemissionReturnReceiptActionsComponent]
+    }).compileComponents();
+
+    fixture = TestBed.createComponent(RemissionReturnReceiptActionsComponent);
+    component = fixture.componentInstance;
+  });
+
+  it('should disable delete button when items exist', () => {
+    fixture.componentRef.setInput('remissionReturn', {
+      id: 123,
+      receipts: [{ id: 456, data: { items: [{ id: 1 }] } }]
+    });
+    fixture.detectChanges();
+
+    const deleteBtn = fixture.nativeElement.querySelector('[data-what="return-receipt-delete-button"]');
+    expect(deleteBtn?.disabled).toBe(true);
+  });
+
+  it('should emit reloadData after successful deletion', async () => {
+    const reloadSpy = vi.fn();
+    component.reloadData.subscribe(reloadSpy);
+
+    await component.onDelete();
+
+    expect(reloadSpy).toHaveBeenCalled();
+  });
+});
+```
+
+## Dependencies
+
+- `@angular/core` - Angular framework
+- `@angular/router` - Navigation
+- `@isa/remission/data-access` - RemissionStore, RemissionReturnReceiptService, Return types
+- `@isa/remission/shared/remission-start-dialog` - RemissionStartService
+- `@isa/ui/buttons` - Button components
+- `@isa/ui/dialog` - Confirmation dialog
+- `@isa/core/tabs` - Tab ID injection
+- `@isa/core/logging` - Logger service
+
+## Architecture Notes
+
+**State Synchronization**: Both components integrate tightly with RemissionStore to ensure UI state matches backend state.
+
+**Navigation Integration**: Uses Angular Router and tab ID for context-aware navigation within multi-tab environments.
+
+**Error Handling**: Comprehensive error logging with contextual information for debugging.
+
+**User Confirmations**: Critical actions (changing remission, completing groups) require explicit user confirmation.
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/remission/shared/search-item-to-remit-dialog/README.md b/libs/remission/shared/search-item-to-remit-dialog/README.md
index 19108bf08..117f1ea66 100644
--- a/libs/remission/shared/search-item-to-remit-dialog/README.md
+++ b/libs/remission/shared/search-item-to-remit-dialog/README.md
@@ -1,7 +1,143 @@
-# remission-shared-search-item-to-remit-dialog
+# @isa/remission/shared/search-item-to-remit-dialog
 
-This library was generated with [Nx](https://nx.dev).
+Angular dialog component for searching and adding items to remission lists that are not on the mandatory return list (Pflichtremission).
 
-## Running unit tests
+## Overview
 
-Run `nx test remission-shared-search-item-to-remit-dialog` to execute the unit tests.
+The Search Item to Remit Dialog library provides a specialized dialog workflow for adding items to remission processes that aren't pre-populated in the mandatory remission list. Users can search for products by EAN or name, view stock information, and specify quantity and reason for returns. This enables flexible remission workflows beyond pre-defined lists.
+
+## Features
+
+- **Product Search** - Search by EAN or product name with real-time results
+- **Stock Information** - Display current in-stock quantities
+- **Quantity & Reason Selection** - Specify remit quantity and return reason
+- **Validation** - Ensure quantities don't exceed available stock
+- **ReturnItem Results** - Returns only ReturnItem types (#5273, #4768)
+- **Responsive Layout** - Adapts to desktop/mobile breakpoints
+- **InStock Resource** - Batched stock fetching for search results
+
+## Quick Start
+
+```typescript
+import { SearchItemToRemitDialogComponent } from '@isa/remission/shared/search-item-to-remit-dialog';
+
+@Component({
+  imports: [SearchItemToRemitDialogComponent]
+})
+export class MyComponent {
+  dialog = injectDialog(SearchItemToRemitDialogComponent);
+
+  async openSearch(searchTerm: string) {
+    const dialogRef = this.dialog({
+      data: { searchTerm },
+      width: '48rem'
+    });
+
+    const result = await firstValueFrom(dialogRef.closed);
+    if (result) {
+      // result is ReturnItem[]
+      console.log('Selected items:', result);
+    }
+  }
+}
+```
+
+## Component API
+
+### SearchItemToRemitDialogComponent
+
+Main dialog container that manages the search workflow.
+
+**Selector**: `remi-search-item-to-remit-dialog`
+
+**Dialog Data**:
+```typescript
+{
+  searchTerm: string | Signal<string>
+}
+```
+
+**Dialog Result**: `ReturnItem[] | undefined`
+
+### SearchItemToRemitListComponent
+
+Displays list of search results with stock information.
+
+**Features**:
+- Catalog item search via CatSearchService
+- In-stock quantity display
+- Click handlers for item selection
+
+### SelectRemiQuantityAndReasonDialogComponent
+
+Nested dialog for specifying quantity and reason.
+
+**Inputs**:
+- `item`: Item (Product to remit)
+- `inStock`: number (Available quantity)
+
+**Result**: `ReturnItem[]`
+
+## Usage Example
+
+```typescript
+import { SearchItemToRemitDialogComponent } from '@isa/remission/shared/search-item-to-remit-dialog';
+
+@Component({
+  selector: 'app-remission-list',
+  imports: [SearchItemToRemitDialogComponent]
+})
+export class RemissionListComponent {
+  #dialog = injectDialog(SearchItemToRemitDialogComponent);
+  #store = inject(RemissionStore);
+
+  async addItemNotOnList(searchTerm: string) {
+    const dialogRef = this.#dialog({
+      data: { searchTerm: signal(searchTerm) },
+      width: '48rem'
+    });
+
+    const returnItems = await firstValueFrom(dialogRef.closed);
+
+    if (returnItems && this.#store.remissionStarted()) {
+      for (const item of returnItems) {
+        this.#store.selectRemissionItem(item.id, item);
+      }
+      await this.remitItems();
+    }
+  }
+}
+```
+
+## Architecture Notes
+
+**Search Flow**:
+1. User enters search term (EAN or product name)
+2. SearchItemToRemitListComponent searches catalog
+3. InStockResource fetches stock for results
+4. User clicks item → SelectRemiQuantityAndReasonDialog opens
+5. User specifies quantity and reason
+6. Dialog closes with ReturnItem array
+
+**Stock Resource**: Uses BatchingResource pattern for efficient stock fetching across multiple items.
+
+**Type Safety**: #5273, #4768 - Only ReturnItem types allowed to prevent incorrect data flow.
+
+## Testing
+
+```bash
+npx nx test remission-search-item-to-remit-dialog --skip-nx-cache
+```
+
+## Dependencies
+
+- `@angular/core` - Angular framework
+- `@isa/remission/data-access` - ReturnItem types
+- `@isa/catalogue/data-access` - Item search
+- `@isa/ui/dialog` - Dialog infrastructure
+- `@isa/ui/layout` - Breakpoint service
+- `@isa/remission/shared/product` - ProductInfoComponent
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/shared/address/README.md b/libs/shared/address/README.md
index 59003dd89..b075f2617 100644
--- a/libs/shared/address/README.md
+++ b/libs/shared/address/README.md
@@ -1,7 +1,1075 @@
-# shared-address
+# @isa/shared/address
 
-This library was generated with [Nx](https://nx.dev).
+Comprehensive Angular components for displaying addresses in both multi-line and inline formats with automatic country name resolution and intelligent formatting.
 
-## Running unit tests
+## Overview
 
-Run `nx test shared-address` to execute the unit tests.
+The Address library provides two standalone components for rendering addresses in different layouts. It automatically formats address data, handles country name lookups, and applies special rules for German addresses. The library integrates with the CRM data access layer to resolve ISO country codes to localized country names.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Address Formatting Rules](#address-formatting-rules)
+- [Architecture Notes](#architecture-notes)
+- [Testing](#testing)
+- [Dependencies](#dependencies)
+
+## Features
+
+- **Two display modes** - Multi-line (`shared-address`) and single-line (`shared-inline-address`) formats
+- **Country name resolution** - Automatic ISO 3166 Alpha-3 country code to name conversion
+- **German address handling** - Special rule to hide country for German addresses
+- **Care of (c/o) support** - Proper formatting of care-of address lines
+- **Signal-based reactivity** - Efficient computed properties for address line formatting
+- **Optional fields** - Graceful handling of missing address components
+- **E2E testing attributes** - Built-in `data-what` and `data-which` attributes
+- **Standalone components** - Modern Angular architecture with explicit imports
+- **Flexible input** - Accepts partial addresses with optional fields
+- **Type-safe interface** - TypeScript interface for address data structure
+
+## Quick Start
+
+### 1. Multi-Line Address Display
+
+```typescript
+import { Component } from '@angular/core';
+import { AddressComponent, Address } from '@isa/shared/address';
+
+@Component({
+  selector: 'app-customer-details',
+  standalone: true,
+  imports: [AddressComponent],
+  template: `
+    <div class="address-section">
+      <h3>Shipping Address</h3>
+      <shared-address [address]="shippingAddress" />
+    </div>
+  `
+})
+export class CustomerDetailsComponent {
+  shippingAddress: Address = {
+    careOf: 'John Doe',
+    street: 'Hauptstraße',
+    streetNumber: '123',
+    apartment: 'Apt 4B',
+    zipCode: '10115',
+    city: 'Berlin',
+    country: 'DEU'
+  };
+}
+```
+
+### 2. Inline Address Display
+
+```typescript
+import { Component } from '@angular/core';
+import { InlineAddressComponent, Address } from '@isa/shared/address';
+
+@Component({
+  selector: 'app-order-summary',
+  standalone: true,
+  imports: [InlineAddressComponent],
+  template: `
+    <div class="order-info">
+      <span class="label">Delivery to:</span>
+      <shared-inline-address [address]="deliveryAddress" />
+    </div>
+  `
+})
+export class OrderSummaryComponent {
+  deliveryAddress: Address = {
+    street: 'Bakerstreet',
+    streetNumber: '221B',
+    zipCode: 'NW1 6XE',
+    city: 'London',
+    country: 'GBR'
+  };
+}
+```
+
+### 3. Partial Address Handling
+
+```typescript
+import { Component } from '@angular/core';
+import { AddressComponent, Address } from '@isa/shared/address';
+
+@Component({
+  selector: 'app-address-card',
+  standalone: true,
+  imports: [AddressComponent],
+  template: `
+    <shared-address [address]="partialAddress" />
+  `
+})
+export class AddressCardComponent {
+  // All fields are optional - component handles missing data gracefully
+  partialAddress: Address = {
+    street: 'Main Street',
+    zipCode: '12345',
+    city: 'Springfield'
+    // Missing: streetNumber, apartment, country, etc.
+  };
+}
+```
+
+## Core Concepts
+
+### Address Data Structure
+
+The `Address` interface defines the structure for address data:
+
+```typescript
+export interface Address {
+  apartment?: string;      // Apartment/suite number
+  careOf?: string;         // Care of (c/o) recipient
+  city?: string;           // City name
+  country?: string;        // ISO 3166 Alpha-3 country code (e.g., 'DEU', 'GBR', 'USA')
+  district?: string;       // District (currently not displayed)
+  info?: string;           // Additional address information
+  po?: string;             // P.O. Box (currently not displayed)
+  region?: string;         // Region (currently not displayed)
+  state?: string;          // State (currently not displayed)
+  street?: string;         // Street name
+  streetNumber?: string;   // Street number
+  zipCode?: string;        // ZIP/Postal code
+}
+```
+
+**All fields are optional** to support partial addresses.
+
+### Multi-Line Format
+
+The `AddressComponent` displays addresses in a structured multi-line format:
+
+```
+c/o John Doe
+Hauptstraße 123 Apt 4B
+Additional info
+10115 Berlin
+```
+
+**Lines displayed:**
+1. **Care of line**: `c/o {careOf}` (if careOf exists)
+2. **Street line**: `{street} {streetNumber} {apartment}` (if any exist)
+3. **Info line**: `{info}` (if exists)
+4. **City line**: `{zipCode} {city}` (if any exist), optionally `, {country}` (if non-German)
+
+### Inline Format
+
+The `InlineAddressComponent` displays addresses in a single line:
+
+```
+Hauptstraße 123, 10115 Berlin
+```
+
+**Format:** `{street} {streetNumber}, {zipCode} {city}` optionally `, {country}` (if non-German)
+
+### Country Name Resolution
+
+Both components automatically resolve ISO 3166 Alpha-3 country codes to localized country names:
+
+```typescript
+// Input
+country: 'GBR'
+
+// Displayed
+"United Kingdom"
+```
+
+The resolution uses the `CountryResource` from `@isa/crm/data-access`.
+
+### German Address Special Rule
+
+Addresses with country code `'DEU'` (Germany) do not display the country name:
+
+```typescript
+// German address
+{
+  street: 'Bahnhofstraße',
+  streetNumber: '1',
+  zipCode: '80335',
+  city: 'München',
+  country: 'DEU'
+}
+// Displays: "80335 München" (no "Germany")
+
+// Non-German address
+{
+  street: 'Rue de Rivoli',
+  streetNumber: '99',
+  zipCode: '75001',
+  city: 'Paris',
+  country: 'FRA'
+}
+// Displays: "75001 Paris, France"
+```
+
+This improves readability for the primary market (Germany) while maintaining clarity for international addresses.
+
+## API Reference
+
+### AddressComponent
+
+Multi-line address display component with structured formatting.
+
+**Selector:** `shared-address`
+
+**Standalone:** `true`
+
+#### Inputs
+
+##### `address` (optional)
+- **Type:** `InputSignal<Address | undefined>`
+- **Description:** Address data to display
+- **Default:** `undefined`
+
+#### Template Structure
+
+```html
+<div class="flex flex-col" data-what="address-display">
+  @if (careOfLine()) {
+    <div data-which="care-of-line">{{ careOfLine() }}</div>
+  }
+  @if (streetLine()) {
+    <div data-which="street-line">{{ streetLine() }}</div>
+  }
+  @if (a.info) {
+    <div data-which="info">{{ a.info }}</div>
+  }
+  @if (cityLine()) {
+    <div data-which="city-line">{{ cityLine() }}</div>
+  }
+</div>
+```
+
+#### Computed Properties
+
+##### `careOfLine()`
+- **Type:** `Signal<string>`
+- **Returns:** `'c/o {careOf}'` if careOf exists, otherwise empty string
+
+##### `streetLine()`
+- **Type:** `Signal<string>`
+- **Returns:** Space-separated combination of street, streetNumber, and apartment
+- **Example:** `'Hauptstraße 123 Apt 4B'`
+
+##### `cityLine()`
+- **Type:** `Signal<string>`
+- **Returns:** Zip code and city, optionally with country name if non-German
+- **Example:** `'10115 Berlin'` or `'75001 Paris, France'`
+
+#### Example
+
+```typescript
+<shared-address
+  [address]="{
+    careOf: 'Jane Smith',
+    street: 'Main Street',
+    streetNumber: '456',
+    zipCode: '10001',
+    city: 'New York',
+    country: 'USA'
+  }"
+/>
+
+<!-- Renders as:
+c/o Jane Smith
+Main Street 456
+10001 New York, United States
+-->
+```
+
+### InlineAddressComponent
+
+Single-line address display component for compact layouts.
+
+**Selector:** `shared-inline-address`
+
+**Standalone:** `true`
+
+#### Inputs
+
+##### `address` (optional)
+- **Type:** `InputSignal<Address | undefined>`
+- **Description:** Address data to display
+- **Default:** `undefined`
+
+#### Template Structure
+
+```html
+@if (addressLine()) {
+  {{ addressLine() }}
+}
+```
+
+#### Computed Properties
+
+##### `addressLine()`
+- **Type:** `Signal<string>`
+- **Returns:** Comma-separated address components with country if non-German
+- **Format:** `{street} {streetNumber}, {zipCode} {city}` optionally `, {country}`
+- **Example:** `'Baker Street 221B, NW1 6XE London, United Kingdom'`
+
+#### Example
+
+```typescript
+<shared-inline-address
+  [address]="{
+    street: 'Oxford Street',
+    streetNumber: '100',
+    zipCode: 'W1D 1LL',
+    city: 'London',
+    country: 'GBR'
+  }"
+/>
+
+<!-- Renders as:
+Oxford Street 100, W1D 1LL London, United Kingdom
+-->
+```
+
+### Address Interface
+
+Type definition for address data structure.
+
+```typescript
+export interface Address {
+  apartment?: string;      // Apartment/suite number
+  careOf?: string;         // Care of (c/o) recipient
+  city?: string;           // City name
+  country?: string;        // ISO 3166 Alpha-3 country code
+  district?: string;       // District (not currently displayed)
+  info?: string;           // Additional information
+  po?: string;             // P.O. Box (not currently displayed)
+  region?: string;         // Region (not currently displayed)
+  state?: string;          // State (not currently displayed)
+  street?: string;         // Street name
+  streetNumber?: string;   // Street number
+  zipCode?: string;        // ZIP/Postal code
+}
+```
+
+**All fields are optional** to support various address formats and partial data.
+
+## Usage Examples
+
+### Customer Shipping Address
+
+```typescript
+import { Component } from '@angular/core';
+import { AddressComponent, Address } from '@isa/shared/address';
+
+@Component({
+  selector: 'app-customer-shipping',
+  standalone: true,
+  imports: [AddressComponent],
+  template: `
+    <div class="shipping-section">
+      <h2 class="isa-text-heading-3-bold">Shipping Address</h2>
+      <shared-address [address]="shippingAddress" />
+
+      <button (click)="editAddress()">Edit Address</button>
+    </div>
+  `,
+  styles: [`
+    .shipping-section {
+      padding: 1rem;
+      border: 1px solid var(--isa-neutral-300);
+      border-radius: 0.5rem;
+    }
+  `]
+})
+export class CustomerShippingComponent {
+  shippingAddress: Address = {
+    careOf: 'Maria Schmidt',
+    street: 'Kurfürstendamm',
+    streetNumber: '100',
+    apartment: 'Wohnung 5',
+    info: 'Hinterhaus, 2. Stock',
+    zipCode: '10709',
+    city: 'Berlin',
+    country: 'DEU'
+  };
+
+  editAddress(): void {
+    // Navigate to address edit form
+  }
+}
+```
+
+### Order Summary with Inline Address
+
+```typescript
+import { Component, input } from '@angular/core';
+import { InlineAddressComponent, Address } from '@isa/shared/address';
+
+interface Order {
+  orderId: string;
+  deliveryAddress: Address;
+  totalAmount: number;
+}
+
+@Component({
+  selector: 'app-order-summary',
+  standalone: true,
+  imports: [InlineAddressComponent],
+  template: `
+    <div class="order-summary">
+      <h3>Order #{{ order().orderId }}</h3>
+
+      <div class="order-details">
+        <div class="detail-row">
+          <span class="label">Delivery to:</span>
+          <shared-inline-address [address]="order().deliveryAddress" />
+        </div>
+
+        <div class="detail-row">
+          <span class="label">Total:</span>
+          <span>{{ order().totalAmount | currency }}</span>
+        </div>
+      </div>
+    </div>
+  `
+})
+export class OrderSummaryComponent {
+  order = input.required<Order>();
+}
+```
+
+### Address List with Both Formats
+
+```typescript
+import { Component } from '@angular/core';
+import { AddressComponent, InlineAddressComponent, Address } from '@isa/shared/address';
+import { breakpoint, Breakpoint } from '@isa/ui/layout';
+
+@Component({
+  selector: 'app-address-list',
+  standalone: true,
+  imports: [AddressComponent, InlineAddressComponent],
+  template: `
+    <div class="address-list">
+      @for (address of addresses; track address.id) {
+        <div class="address-card">
+          <h4>{{ address.type }}</h4>
+
+          <!-- Desktop: Multi-line format -->
+          @if (isDesktop()) {
+            <shared-address [address]="address.data" />
+          }
+
+          <!-- Mobile: Inline format -->
+          @else {
+            <shared-inline-address [address]="address.data" />
+          }
+
+          <button (click)="selectAddress(address.id)">
+            Select
+          </button>
+        </div>
+      }
+    </div>
+  `
+})
+export class AddressListComponent {
+  isDesktop = breakpoint([Breakpoint.Desktop, Breakpoint.DekstopL, Breakpoint.DekstopXL]);
+
+  addresses = [
+    {
+      id: 1,
+      type: 'Home',
+      data: {
+        street: 'Lindenstraße',
+        streetNumber: '45',
+        zipCode: '50674',
+        city: 'Köln',
+        country: 'DEU'
+      }
+    },
+    {
+      id: 2,
+      type: 'Office',
+      data: {
+        street: 'Goethestraße',
+        streetNumber: '12',
+        zipCode: '60313',
+        city: 'Frankfurt',
+        country: 'DEU'
+      }
+    }
+  ];
+
+  selectAddress(id: number): void {
+    console.log('Selected address:', id);
+  }
+}
+```
+
+### International Addresses
+
+```typescript
+import { Component } from '@angular/core';
+import { AddressComponent, Address } from '@isa/shared/address';
+
+@Component({
+  selector: 'app-international-addresses',
+  standalone: true,
+  imports: [AddressComponent],
+  template: `
+    <div class="addresses-grid">
+      @for (address of internationalAddresses; track $index) {
+        <div class="address-card">
+          <h4>{{ address.country }}</h4>
+          <shared-address [address]="address" />
+        </div>
+      }
+    </div>
+  `
+})
+export class InternationalAddressesComponent {
+  internationalAddresses: Address[] = [
+    // Germany (country name hidden)
+    {
+      street: 'Alexanderplatz',
+      streetNumber: '1',
+      zipCode: '10178',
+      city: 'Berlin',
+      country: 'DEU'
+    },
+    // United Kingdom (country name shown)
+    {
+      street: 'Downing Street',
+      streetNumber: '10',
+      zipCode: 'SW1A 2AA',
+      city: 'London',
+      country: 'GBR'
+    },
+    // France (country name shown)
+    {
+      street: 'Champs-Élysées',
+      streetNumber: '1',
+      zipCode: '75008',
+      city: 'Paris',
+      country: 'FRA'
+    },
+    // USA (country name shown)
+    {
+      street: 'Pennsylvania Avenue NW',
+      streetNumber: '1600',
+      zipCode: '20500',
+      city: 'Washington',
+      country: 'USA'
+    }
+  ];
+}
+```
+
+### Invoice Address with Care Of
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { AddressComponent, Address } from '@isa/shared/address';
+
+@Component({
+  selector: 'app-invoice-address',
+  standalone: true,
+  imports: [AddressComponent],
+  template: `
+    <div class="invoice-section">
+      <h3 class="isa-text-heading-3-bold">Invoice Address</h3>
+
+      <div class="address-container">
+        <shared-address [address]="invoiceAddress()" />
+      </div>
+
+      @if (showCareOfInput()) {
+        <input
+          type="text"
+          placeholder="Care of recipient"
+          [(ngModel)]="careOfName"
+          (blur)="updateCareOf()"
+        />
+      }
+    </div>
+  `
+})
+export class InvoiceAddressComponent {
+  careOfName = '';
+  showCareOfInput = signal(false);
+
+  invoiceAddress = signal<Address>({
+    street: 'Friedrichstraße',
+    streetNumber: '200',
+    zipCode: '10117',
+    city: 'Berlin',
+    country: 'DEU'
+  });
+
+  updateCareOf(): void {
+    this.invoiceAddress.update(addr => ({
+      ...addr,
+      careOf: this.careOfName || undefined
+    }));
+  }
+}
+```
+
+### Address Comparison
+
+```typescript
+import { Component } from '@angular/core';
+import { AddressComponent, InlineAddressComponent, Address } from '@isa/shared/address';
+
+@Component({
+  selector: 'app-address-comparison',
+  standalone: true,
+  imports: [AddressComponent, InlineAddressComponent],
+  template: `
+    <div class="comparison-container">
+      <div class="address-column">
+        <h3>Billing Address</h3>
+        <shared-address [address]="billingAddress" />
+      </div>
+
+      <div class="address-column">
+        <h3>Shipping Address</h3>
+        <shared-address [address]="shippingAddress" />
+      </div>
+
+      @if (!addressesMatch()) {
+        <div class="warning">
+          Billing and shipping addresses differ
+        </div>
+      }
+    </div>
+  `
+})
+export class AddressComparisonComponent {
+  billingAddress: Address = {
+    street: 'Hauptstraße',
+    streetNumber: '100',
+    zipCode: '10115',
+    city: 'Berlin',
+    country: 'DEU'
+  };
+
+  shippingAddress: Address = {
+    careOf: 'Office Reception',
+    street: 'Nebenstraße',
+    streetNumber: '50',
+    zipCode: '20095',
+    city: 'Hamburg',
+    country: 'DEU'
+  };
+
+  addressesMatch(): boolean {
+    return JSON.stringify(this.billingAddress) === JSON.stringify(this.shippingAddress);
+  }
+}
+```
+
+## Address Formatting Rules
+
+### Street Line Formatting
+
+The street line combines multiple components with spaces:
+
+```typescript
+// All components present
+street: 'Hauptstraße'
+streetNumber: '123'
+apartment: 'Apt 4B'
+// Result: "Hauptstraße 123 Apt 4B"
+
+// Only street and number
+street: 'Main Street'
+streetNumber: '456'
+// Result: "Main Street 456"
+
+// Only street
+street: 'Broadway'
+// Result: "Broadway"
+
+// No components
+// Result: "" (line not displayed)
+```
+
+### City Line Formatting
+
+The city line combines zip code, city, and optionally country:
+
+```typescript
+// German address (country hidden)
+zipCode: '10115'
+city: 'Berlin'
+country: 'DEU'
+// Result: "10115 Berlin"
+
+// Non-German address (country shown)
+zipCode: 'SW1A 1AA'
+city: 'London'
+country: 'GBR'
+// Result: "SW1A 1AA London, United Kingdom"
+
+// Only city
+city: 'Paris'
+// Result: "Paris"
+
+// Only zip
+zipCode: '75001'
+// Result: "75001"
+
+// No components
+// Result: "" (line not displayed)
+```
+
+### Inline Formatting
+
+Inline format uses commas to separate components:
+
+```typescript
+// Full address
+street: 'Oxford Street'
+streetNumber: '100'
+zipCode: 'W1D 1LL'
+city: 'London'
+country: 'GBR'
+// Result: "Oxford Street 100, W1D 1LL London, United Kingdom"
+
+// Partial address
+street: 'Main Street'
+city: 'Springfield'
+// Result: "Main Street, Springfield"
+
+// Only street
+street: 'Broadway'
+// Result: "Broadway"
+```
+
+### Country Name Resolution
+
+The components resolve ISO 3166 Alpha-3 codes to country names:
+
+```typescript
+'DEU' → 'Deutschland' (or localized equivalent)
+'GBR' → 'United Kingdom'
+'USA' → 'United States'
+'FRA' → 'France'
+'AUT' → 'Austria'
+'CHE' → 'Switzerland'
+```
+
+**Fallback**: If country code not found in resource, displays the code itself.
+
+## Architecture Notes
+
+### Design Patterns
+
+#### Computed Signal Pattern
+
+Both components use computed signals for efficient reactive formatting:
+
+```typescript
+streetLine = computed(() => {
+  const a = this.address();
+  if (!a) return '';
+
+  const parts: string[] = [];
+  if (a.street) parts.push(a.street);
+  if (a.streetNumber) parts.push(a.streetNumber);
+  if (a.apartment) parts.push(a.apartment);
+
+  return parts.join(' ');
+});
+```
+
+**Benefits:**
+- Automatic re-computation when address changes
+- Efficient - only recalculates affected computed values
+- OnPush compatible
+- No manual subscription management
+
+#### Resource Integration Pattern
+
+Uses `CountryResource` from CRM data access for country lookups:
+
+```typescript
+#countryResource = inject(CountryResource);
+
+#getCountryName(countryCode: string): string {
+  const countries = this.#countryResource.resource.value();
+  if (!countries || !Array.isArray(countries)) return countryCode;
+
+  const country = countries.find((c) => c.isO3166_A_3 === countryCode);
+  return country?.name || countryCode;
+}
+```
+
+**Benefits:**
+- Centralized country data management
+- Automatic localization support
+- Fallback to code if resource unavailable
+
+#### Optional Field Handling
+
+All address fields are optional, with graceful degradation:
+
+```typescript
+// Component handles undefined/null addresses
+@if (address(); as a) {
+  // Display logic
+}
+
+// Computed properties return empty strings for missing data
+if (!a || !a.careOf) return '';
+```
+
+### Component Separation
+
+Two components serve different use cases:
+
+- **`AddressComponent`**: Structured multi-line display for detailed views
+- **`InlineAddressComponent`**: Compact single-line for lists and summaries
+
+This separation of concerns improves:
+- Code maintainability
+- Component reusability
+- Performance (import only what you need)
+
+### E2E Testing Support
+
+Both components include `data-what` and `data-which` attributes for automated testing:
+
+```html
+<div class="flex flex-col" data-what="address-display">
+  <div data-which="care-of-line">...</div>
+  <div data-which="street-line">...</div>
+  <div data-which="info">...</div>
+  <div data-which="city-line">...</div>
+</div>
+```
+
+### Performance Considerations
+
+1. **Computed Signals** - Efficient change detection with minimal recalculations
+2. **OnPush Compatible** - Works with OnPush change detection strategy
+3. **Lazy Resource Loading** - Country resource loaded on demand
+4. **Minimal DOM** - Only renders lines with actual content
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **State/Region Display** - Add support for displaying state/region field
+2. **P.O. Box Support** - Integrate po field into formatting logic
+3. **Custom Formatting** - Allow custom format templates via input
+4. **Address Validation** - Integrate with address validation service
+5. **Localization** - Locale-specific address formatting rules
+6. **Copy to Clipboard** - Built-in copy functionality
+7. **Map Integration** - Optional map link for addresses
+
+## Testing
+
+The library uses **Vitest** with **Angular Testing Utilities** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test shared-address --skip-nx-cache
+
+# Run tests with coverage
+npx nx test shared-address --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test shared-address --watch
+```
+
+### Test Structure
+
+The library includes unit tests covering:
+
+- **Address rendering** - Tests multi-line and inline formatting
+- **Country resolution** - Tests country name lookup
+- **German address handling** - Tests country name hiding for DEU
+- **Missing fields** - Tests graceful handling of partial addresses
+- **E2E attributes** - Tests presence of data-what and data-which attributes
+
+### Example Test
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { AddressComponent, Address } from '@isa/shared/address';
+import { CountryResource } from '@isa/crm/data-access';
+
+describe('AddressComponent', () => {
+  let component: AddressComponent;
+  let fixture: ComponentFixture<AddressComponent>;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      imports: [AddressComponent],
+      providers: [
+        // Mock CountryResource
+        {
+          provide: CountryResource,
+          useValue: {
+            resource: {
+              value: () => [
+                { isO3166_A_3: 'DEU', name: 'Germany' },
+                { isO3166_A_3: 'GBR', name: 'United Kingdom' }
+              ]
+            }
+          }
+        }
+      ]
+    }).compileComponents();
+
+    fixture = TestBed.createComponent(AddressComponent);
+    component = fixture.componentInstance;
+  });
+
+  it('should display multi-line address', () => {
+    const testAddress: Address = {
+      street: 'Main Street',
+      streetNumber: '123',
+      zipCode: '12345',
+      city: 'Berlin',
+      country: 'DEU'
+    };
+
+    fixture.componentRef.setInput('address', testAddress);
+    fixture.detectChanges();
+
+    const element = fixture.nativeElement;
+    expect(element.textContent).toContain('Main Street 123');
+    expect(element.textContent).toContain('12345 Berlin');
+    expect(element.textContent).not.toContain('Germany'); // Hidden for DEU
+  });
+
+  it('should display country for non-German addresses', () => {
+    const testAddress: Address = {
+      street: 'Oxford Street',
+      streetNumber: '100',
+      zipCode: 'W1D 1LL',
+      city: 'London',
+      country: 'GBR'
+    };
+
+    fixture.componentRef.setInput('address', testAddress);
+    fixture.detectChanges();
+
+    expect(fixture.nativeElement.textContent).toContain('United Kingdom');
+  });
+});
+```
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework for components and signals
+- `@isa/crm/data-access` - CRM data access layer for country resource
+
+### Path Alias
+
+Import from: `@isa/shared/address`
+
+### Exports
+
+- `AddressComponent` - Multi-line address display component
+- `InlineAddressComponent` - Single-line address display component
+- `Address` - TypeScript interface for address data
+
+## Best Practices
+
+### 1. Use Appropriate Component
+
+Choose the right component for your use case:
+
+```typescript
+// Good - Multi-line for detail pages
+<shared-address [address]="customerAddress" />
+
+// Good - Inline for lists and summaries
+<shared-inline-address [address]="deliveryAddress" />
+
+// Avoid - Multi-line in compact layouts
+<div class="compact-list">
+  <shared-address [address]="addr" /> <!-- Too verbose -->
+</div>
+```
+
+### 2. Provide Complete Address Data
+
+Include all relevant address fields:
+
+```typescript
+// Good - Complete address
+const address: Address = {
+  street: 'Hauptstraße',
+  streetNumber: '100',
+  zipCode: '10115',
+  city: 'Berlin',
+  country: 'DEU'
+};
+
+// Acceptable - Partial address (component handles gracefully)
+const partialAddress: Address = {
+  city: 'Berlin'
+};
+```
+
+### 3. Include E2E Attributes in Parent
+
+Add test attributes to parent containers:
+
+```typescript
+<div class="address-section" data-what="customer-address-section">
+  <shared-address [address]="address" />
+</div>
+```
+
+### 4. Handle Missing Addresses
+
+Always handle undefined/null addresses:
+
+```typescript
+// Good - Conditional rendering
+@if (customer().address) {
+  <shared-address [address]="customer().address" />
+} @else {
+  <p>No address available</p>
+}
+
+// Avoid - Direct binding without check (component handles, but better to be explicit)
+<shared-address [address]="possiblyUndefinedAddress" />
+```
+
+### 5. Use Type-Safe Address Objects
+
+Leverage TypeScript for type safety:
+
+```typescript
+import { Address } from '@isa/shared/address';
+
+// Good - Type-safe
+const address: Address = {
+  street: 'Main Street',
+  zipCode: '12345'
+};
+
+// Avoid - Untyped objects
+const address = {
+  street: 'Main Street',
+  zip: '12345' // Wrong property name!
+};
+```
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/shared/product-format/README.md b/libs/shared/product-format/README.md
index 85518da7b..8091c7926 100644
--- a/libs/shared/product-format/README.md
+++ b/libs/shared/product-format/README.md
@@ -1,7 +1,1048 @@
-# shared-product-format
+# @isa/shared/product-format
 
-This library was generated with [Nx](https://nx.dev).
+Angular components for displaying product format information with icons and formatted text, supporting various media types like hardcover, paperback, audio, and digital formats.
 
-## Running unit tests
+## Overview
 
-Run `nx test shared-product-format` to execute the unit tests.
+The Product Format library provides two complementary standalone components for displaying product format information. The `ProductFormatComponent` combines an icon with formatted text, while the `ProductFormatIconComponent` displays just the icon. Both components integrate with the `@isa/icons` library to render format-specific icons and support customizable styling through Tailwind CSS.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Supported Formats](#supported-formats)
+- [Architecture Notes](#architecture-notes)
+- [Testing](#testing)
+- [Dependencies](#dependencies)
+
+## Features
+
+- **Combined format display** - Icon + text in a single component
+- **Icon-only display** - Standalone icon component for compact layouts
+- **Format-specific icons** - Automatic icon selection from ProductFormatIconGroup
+- **Flexible text styling** - Regular or bold format detail text
+- **Signal-based inputs** - Modern Angular signal inputs for reactivity
+- **Case normalization** - Automatic lowercase conversion for icon names
+- **Consistent sizing** - Standardized 1.5rem (24px) icon size
+- **ISA design system** - Integration with ISA Tailwind color palette
+- **E2E testing attributes** - Built-in `data-what` and `data-which` attributes
+- **OnPush change detection** - Optimized performance
+- **Standalone architecture** - Modern Angular components with explicit imports
+
+## Quick Start
+
+### 1. Display Format with Icon and Text
+
+```typescript
+import { Component } from '@angular/core';
+import { ProductFormatComponent } from '@isa/shared/product-format';
+
+@Component({
+  selector: 'app-product-card',
+  standalone: true,
+  imports: [ProductFormatComponent],
+  template: `
+    <div class="product-info">
+      <h3>{{ product.title }}</h3>
+
+      <!-- Format with icon and text -->
+      <shared-product-format
+        [format]="product.format"
+        [formatDetail]="product.formatDetail"
+      />
+    </div>
+  `
+})
+export class ProductCardComponent {
+  product = {
+    title: 'The Great Gatsby',
+    format: 'HC',  // Hardcover icon code
+    formatDetail: 'Hardcover'
+  };
+}
+```
+
+### 2. Display Icon Only
+
+```typescript
+import { Component } from '@angular/core';
+import { ProductFormatIconComponent } from '@isa/shared/product-format';
+
+@Component({
+  selector: 'app-product-list',
+  standalone: true,
+  imports: [ProductFormatIconComponent],
+  template: `
+    <div class="product-grid">
+      @for (product of products; track product.id) {
+        <div class="product-item">
+          <!-- Icon only for compact display -->
+          <shared-product-format-icon [format]="product.format" />
+          <span>{{ product.title }}</span>
+        </div>
+      }
+    </div>
+  `
+})
+export class ProductListComponent {
+  products = [
+    { id: 1, format: 'HC', title: 'Book 1' },
+    { id: 2, format: 'PB', title: 'Book 2' },
+    { id: 3, format: 'EB', title: 'Book 3' }
+  ];
+}
+```
+
+### 3. Bold Format Detail
+
+```typescript
+import { Component } from '@angular/core';
+import { ProductFormatComponent } from '@isa/shared/product-format';
+
+@Component({
+  selector: 'app-product-highlight',
+  standalone: true,
+  imports: [ProductFormatComponent],
+  template: `
+    <shared-product-format
+      [format]="'HC'"
+      [formatDetail]="'Limited Edition Hardcover'"
+      [formatDetailsBold]="true"
+    />
+  `
+})
+export class ProductHighlightComponent {}
+```
+
+## Core Concepts
+
+### Format Codes
+
+Product formats are identified by short codes (typically 2 characters) that map to specific icons:
+
+```typescript
+// Common format codes
+'HC'  → Hardcover
+'PB'  → Paperback
+'EB'  → E-Book
+'AB'  → Audiobook
+'CD'  → CD/Audio
+'DL'  → Download
+```
+
+The format code is automatically converted to lowercase for icon lookup.
+
+### Icon Integration
+
+The components integrate with `@isa/icons` ProductFormatIconGroup:
+
+```typescript
+import { ProductFormatIconGroup } from '@isa/icons';
+import { NgIcon, provideIcons } from '@ng-icons/core';
+
+// Icons are automatically loaded from ProductFormatIconGroup
+providers: [provideIcons(ProductFormatIconGroup)]
+```
+
+### Component Structure
+
+Two components serve different display needs:
+
+- **`ProductFormatComponent`**: Icon + text combination for detailed display
+- **`ProductFormatIconComponent`**: Icon only for compact layouts
+
+```typescript
+// Full display
+<shared-product-format format="HC" formatDetail="Hardcover" />
+// Renders: [HC Icon] Hardcover
+
+// Icon only
+<shared-product-format-icon format="HC" />
+// Renders: [HC Icon]
+```
+
+### Styling
+
+Both components use ISA design system colors and consistent sizing:
+
+- **Icon size**: `1.5rem` (24px) - `size="1.5rem"`
+- **Icon color**: `text-isa-neutral-900` (dark neutral)
+- **Text color**: `text-isa-secondary-900` (dark secondary)
+- **Layout**: Flexbox with `gap-2` (0.5rem spacing)
+
+## API Reference
+
+### ProductFormatComponent
+
+Combined icon and text display component for product formats.
+
+**Selector:** `shared-product-format`
+
+**Change Detection:** `OnPush`
+
+**Standalone:** `true`
+
+#### Inputs
+
+##### `format` (required)
+- **Type:** `InputSignal<string>`
+- **Description:** Format code (e.g., 'HC', 'PB', 'EB')
+- **Usage:** Determines which icon to display
+
+##### `formatDetail` (required)
+- **Type:** `InputSignal<string>`
+- **Description:** Human-readable format description (e.g., 'Hardcover', 'Paperback')
+- **Usage:** Displayed as text next to the icon
+
+##### `formatDetailsBold` (optional)
+- **Type:** `InputSignal<boolean>`
+- **Default:** `false`
+- **Description:** Whether to display format detail text in bold
+- **Styling:**
+  - `false`: `.isa-text-body-2-regular`
+  - `true`: `.isa-text-body-2-bold`
+
+#### Host Bindings
+
+- **`class`**: `["flex", "items-center", "gap-2"]` - Flexbox layout with centered items
+- **`data-what`**: `'product-format'` - E2E testing identifier
+- **`data-which`**: `'shared-product-format'` - Component type identifier
+
+#### Template Structure
+
+```html
+<shared-product-format-icon [format]="format()"></shared-product-format-icon>
+<span
+  [class.isa-text-body-2-regular]="!formatDetailsBold()"
+  [class.isa-text-body-2-bold]="formatDetailsBold()"
+  class="text-isa-secondary-900"
+>
+  {{ formatDetail() }}
+</span>
+```
+
+#### Example
+
+```typescript
+<shared-product-format
+  [format]="'HC'"
+  [formatDetail]="'Hardcover'"
+  [formatDetailsBold]="false"
+/>
+// Renders: [HC Icon] Hardcover (regular weight)
+
+<shared-product-format
+  [format]="'PB'"
+  [formatDetail]="'Paperback'"
+  [formatDetailsBold]="true"
+/>
+// Renders: [PB Icon] Paperback (bold weight)
+```
+
+### ProductFormatIconComponent
+
+Icon-only display component for product formats.
+
+**Selector:** `shared-product-format-icon`
+
+**Standalone:** `true`
+
+#### Inputs
+
+##### `format` (required)
+- **Type:** `InputSignal<string>`
+- **Description:** Format code (e.g., 'HC', 'PB', 'EB')
+- **Processing:** Automatically converted to lowercase via `formatLowerCase()` computed signal
+
+#### Computed Properties
+
+##### `formatLowerCase()`
+- **Type:** `Signal<string>`
+- **Returns:** Lowercase version of the format input
+- **Example:** `'HC'` → `'hc'`, `'PB'` → `'pb'`
+- **Purpose:** Icon names in ProductFormatIconGroup are lowercase
+
+#### Host Bindings
+
+- **`class`**: `["inline-block","text-isa-neutral-900", "size-6"]` - Inline block with neutral color and 24px size
+- **`data-what`**: `'product-format-icon'` - E2E testing identifier
+- **`data-which`**: `'shared-product-format-icon'` - Component type identifier
+
+#### Template Structure
+
+```html
+<ng-icon [name]="formatLowerCase()" size="1.5rem"></ng-icon>
+```
+
+#### Example
+
+```typescript
+<shared-product-format-icon [format]="'HC'" />
+// Renders: Hardcover icon (24x24px)
+
+<shared-product-format-icon [format]="'EB'" />
+// Renders: E-book icon (24x24px)
+```
+
+## Usage Examples
+
+### Product Card with Format
+
+```typescript
+import { Component, input } from '@angular/core';
+import { ProductFormatComponent } from '@isa/shared/product-format';
+import { ProductImageDirective } from '@isa/shared/product-image';
+
+interface Product {
+  ean: string;
+  title: string;
+  author: string;
+  format: string;
+  formatDetail: string;
+  price: number;
+}
+
+@Component({
+  selector: 'app-product-card',
+  standalone: true,
+  imports: [ProductFormatComponent, ProductImageDirective],
+  template: `
+    <div class="product-card">
+      <img
+        sharedProductImage
+        [ean]="product().ean"
+        [imageWidth]="200"
+        [imageHeight]="300"
+        alt="{{ product().title }}"
+      />
+
+      <div class="product-info">
+        <h3 class="isa-text-heading-4-bold">{{ product().title }}</h3>
+        <p class="isa-text-body-2-regular">{{ product().author }}</p>
+
+        <shared-product-format
+          [format]="product().format"
+          [formatDetail]="product().formatDetail"
+        />
+
+        <p class="price">{{ product().price | currency }}</p>
+      </div>
+    </div>
+  `,
+  styles: [`
+    .product-card {
+      display: flex;
+      flex-direction: column;
+      gap: 1rem;
+      padding: 1rem;
+      border: 1px solid var(--isa-neutral-300);
+      border-radius: 0.5rem;
+    }
+  `]
+})
+export class ProductCardComponent {
+  product = input.required<Product>();
+}
+```
+
+### Product List with Icon Only
+
+```typescript
+import { Component } from '@angular/core';
+import { ProductFormatIconComponent } from '@isa/shared/product-format';
+
+@Component({
+  selector: 'app-compact-product-list',
+  standalone: true,
+  imports: [ProductFormatIconComponent],
+  template: `
+    <table class="product-table">
+      <thead>
+        <tr>
+          <th>Format</th>
+          <th>Title</th>
+          <th>Price</th>
+        </tr>
+      </thead>
+      <tbody>
+        @for (product of products; track product.ean) {
+          <tr>
+            <td>
+              <shared-product-format-icon [format]="product.format" />
+            </td>
+            <td>{{ product.title }}</td>
+            <td>{{ product.price | currency }}</td>
+          </tr>
+        }
+      </tbody>
+    </table>
+  `
+})
+export class CompactProductListComponent {
+  products = [
+    { ean: '1234567890123', format: 'HC', title: 'Book Title 1', price: 29.99 },
+    { ean: '2345678901234', format: 'PB', title: 'Book Title 2', price: 14.99 },
+    { ean: '3456789012345', format: 'EB', title: 'Book Title 3', price: 9.99 },
+    { ean: '4567890123456', format: 'AB', title: 'Book Title 4', price: 19.99 }
+  ];
+}
+```
+
+### Format Filter/Facets
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { ProductFormatComponent } from '@isa/shared/product-format';
+
+interface FormatFilter {
+  code: string;
+  label: string;
+  count: number;
+}
+
+@Component({
+  selector: 'app-format-filter',
+  standalone: true,
+  imports: [ProductFormatComponent],
+  template: `
+    <div class="filter-section">
+      <h3 class="isa-text-heading-4-bold">Filter by Format</h3>
+
+      <div class="format-options">
+        @for (format of availableFormats; track format.code) {
+          <label class="format-option">
+            <input
+              type="checkbox"
+              [value]="format.code"
+              (change)="toggleFormat(format.code)"
+            />
+
+            <shared-product-format
+              [format]="format.code"
+              [formatDetail]="format.label + ' (' + format.count + ')'"
+              [formatDetailsBold]="isSelected(format.code)"
+            />
+          </label>
+        }
+      </div>
+    </div>
+  `,
+  styles: [`
+    .format-option {
+      display: flex;
+      align-items: center;
+      gap: 0.5rem;
+      padding: 0.5rem;
+      cursor: pointer;
+    }
+
+    .format-option:hover {
+      background-color: var(--isa-neutral-100);
+    }
+  `]
+})
+export class FormatFilterComponent {
+  availableFormats: FormatFilter[] = [
+    { code: 'HC', label: 'Hardcover', count: 125 },
+    { code: 'PB', label: 'Paperback', count: 342 },
+    { code: 'EB', label: 'E-Book', count: 218 },
+    { code: 'AB', label: 'Audiobook', count: 89 }
+  ];
+
+  selectedFormats = signal<Set<string>>(new Set());
+
+  toggleFormat(code: string): void {
+    this.selectedFormats.update(formats => {
+      const newFormats = new Set(formats);
+      if (newFormats.has(code)) {
+        newFormats.delete(code);
+      } else {
+        newFormats.add(code);
+      }
+      return newFormats;
+    });
+  }
+
+  isSelected(code: string): boolean {
+    return this.selectedFormats().has(code);
+  }
+}
+```
+
+### Product Detail Page
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { ProductFormatComponent } from '@isa/shared/product-format';
+
+interface ProductVariant {
+  format: string;
+  formatDetail: string;
+  price: number;
+  available: boolean;
+}
+
+@Component({
+  selector: 'app-product-detail',
+  standalone: true,
+  imports: [ProductFormatComponent],
+  template: `
+    <div class="product-detail">
+      <h2 class="isa-text-heading-2-bold">{{ productTitle }}</h2>
+
+      <div class="format-selection">
+        <h3 class="isa-text-heading-4-bold">Choose Format</h3>
+
+        <div class="format-variants">
+          @for (variant of variants; track variant.format) {
+            <button
+              class="variant-button"
+              [class.selected]="selectedFormat() === variant.format"
+              [disabled]="!variant.available"
+              (click)="selectFormat(variant.format)"
+            >
+              <shared-product-format
+                [format]="variant.format"
+                [formatDetail]="variant.formatDetail"
+                [formatDetailsBold]="selectedFormat() === variant.format"
+              />
+
+              <span class="variant-price">
+                {{ variant.price | currency }}
+              </span>
+
+              @if (!variant.available) {
+                <span class="unavailable">Out of Stock</span>
+              }
+            </button>
+          }
+        </div>
+      </div>
+    </div>
+  `,
+  styles: [`
+    .variant-button {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      width: 100%;
+      padding: 1rem;
+      border: 2px solid var(--isa-neutral-300);
+      border-radius: 0.5rem;
+      cursor: pointer;
+      transition: all 0.2s;
+    }
+
+    .variant-button:hover:not(:disabled) {
+      border-color: var(--isa-accent-500);
+    }
+
+    .variant-button.selected {
+      border-color: var(--isa-accent-500);
+      background-color: var(--isa-accent-50);
+    }
+
+    .variant-button:disabled {
+      opacity: 0.5;
+      cursor: not-allowed;
+    }
+  `]
+})
+export class ProductDetailComponent {
+  productTitle = 'The Great Gatsby';
+
+  variants: ProductVariant[] = [
+    { format: 'HC', formatDetail: 'Hardcover', price: 29.99, available: true },
+    { format: 'PB', formatDetail: 'Paperback', price: 14.99, available: true },
+    { format: 'EB', formatDetail: 'E-Book', price: 9.99, available: true },
+    { format: 'AB', formatDetail: 'Audiobook', price: 19.99, available: false }
+  ];
+
+  selectedFormat = signal<string>('HC');
+
+  selectFormat(format: string): void {
+    this.selectedFormat.set(format);
+  }
+}
+```
+
+### Shopping Cart Item
+
+```typescript
+import { Component, input, output } from '@angular/core';
+import { ProductFormatComponent } from '@isa/shared/product-format';
+
+interface CartItem {
+  id: number;
+  title: string;
+  format: string;
+  formatDetail: string;
+  quantity: number;
+  price: number;
+}
+
+@Component({
+  selector: 'app-cart-item',
+  standalone: true,
+  imports: [ProductFormatComponent],
+  template: `
+    <div class="cart-item">
+      <div class="item-info">
+        <h4 class="isa-text-body-1-bold">{{ item().title }}</h4>
+
+        <shared-product-format
+          [format]="item().format"
+          [formatDetail]="item().formatDetail"
+        />
+      </div>
+
+      <div class="item-controls">
+        <div class="quantity-controls">
+          <button (click)="decreaseQuantity()">-</button>
+          <span>{{ item().quantity }}</span>
+          <button (click)="increaseQuantity()">+</button>
+        </div>
+
+        <div class="item-price">
+          {{ item().price * item().quantity | currency }}
+        </div>
+
+        <button (click)="remove()" class="remove-button">
+          Remove
+        </button>
+      </div>
+    </div>
+  `
+})
+export class CartItemComponent {
+  item = input.required<CartItem>();
+
+  quantityChange = output<number>();
+  removeItem = output<void>();
+
+  increaseQuantity(): void {
+    this.quantityChange.emit(this.item().quantity + 1);
+  }
+
+  decreaseQuantity(): void {
+    if (this.item().quantity > 1) {
+      this.quantityChange.emit(this.item().quantity - 1);
+    }
+  }
+
+  remove(): void {
+    this.removeItem.emit();
+  }
+}
+```
+
+### Format Legend/Guide
+
+```typescript
+import { Component } from '@angular/core';
+import { ProductFormatComponent } from '@isa/shared/product-format';
+
+@Component({
+  selector: 'app-format-legend',
+  standalone: true,
+  imports: [ProductFormatComponent],
+  template: `
+    <div class="format-legend">
+      <h3 class="isa-text-heading-4-bold">Format Guide</h3>
+
+      <div class="legend-items">
+        @for (format of formatLegend; track format.code) {
+          <div class="legend-item">
+            <shared-product-format
+              [format]="format.code"
+              [formatDetail]="format.label"
+            />
+
+            <p class="isa-text-body-2-regular text-isa-neutral-700">
+              {{ format.description }}
+            </p>
+          </div>
+        }
+      </div>
+    </div>
+  `,
+  styles: [`
+    .legend-item {
+      display: flex;
+      flex-direction: column;
+      gap: 0.5rem;
+      padding: 1rem;
+      border-bottom: 1px solid var(--isa-neutral-200);
+    }
+  `]
+})
+export class FormatLegendComponent {
+  formatLegend = [
+    {
+      code: 'HC',
+      label: 'Hardcover',
+      description: 'Durable hardbound book with rigid protective cover'
+    },
+    {
+      code: 'PB',
+      label: 'Paperback',
+      description: 'Softcover book with flexible paper cover'
+    },
+    {
+      code: 'EB',
+      label: 'E-Book',
+      description: 'Digital book format for e-readers and tablets'
+    },
+    {
+      code: 'AB',
+      label: 'Audiobook',
+      description: 'Audio recording of book read aloud'
+    }
+  ];
+}
+```
+
+## Supported Formats
+
+### Common Media Formats
+
+The library supports various product format codes through the ProductFormatIconGroup:
+
+| Code | Format | Description |
+|------|--------|-------------|
+| `HC` | Hardcover | Hardbound books with rigid covers |
+| `PB` | Paperback | Softcover books with flexible covers |
+| `EB` | E-Book | Digital book formats |
+| `AB` | Audiobook | Audio recordings of books |
+| `CD` | CD/Audio | Physical audio discs |
+| `DL` | Download | Digital download products |
+| `BR` | Blu-ray | High-definition video discs |
+| `DVD` | DVD | Standard definition video discs |
+
+### Icon Naming Convention
+
+All format codes are automatically converted to lowercase for icon lookup:
+
+```typescript
+format: 'HC'  →  icon name: 'hc'
+format: 'PB'  →  icon name: 'pb'
+format: 'EB'  →  icon name: 'eb'
+```
+
+This ensures consistent icon resolution regardless of input casing.
+
+## Architecture Notes
+
+### Design Patterns
+
+#### Composition Pattern
+
+`ProductFormatComponent` composes `ProductFormatIconComponent`:
+
+```typescript
+@Component({
+  template: `
+    <shared-product-format-icon [format]="format()"></shared-product-format-icon>
+    <span>{{ formatDetail() }}</span>
+  `,
+  imports: [ProductFormatIconComponent]
+})
+export class ProductFormatComponent {}
+```
+
+**Benefits:**
+- Code reuse - icon component used independently or within format component
+- Single responsibility - each component has clear purpose
+- Flexibility - consumers choose icon-only or icon+text display
+
+#### Computed Signal for Case Normalization
+
+Icon component uses computed signal for case conversion:
+
+```typescript
+formatLowerCase = computed(() => this.format()?.toLowerCase());
+```
+
+**Benefits:**
+- Automatic reactivity when format input changes
+- Efficient - only recalculates when format changes
+- OnPush compatible
+- No manual string manipulation in template
+
+#### Host Class Binding
+
+Both components use host bindings for consistent styling:
+
+```typescript
+// ProductFormatComponent
+host: {
+  '[class]': '["flex", "items-center", "gap-2"]',
+  'data-what': 'product-format',
+  'data-which': 'shared-product-format'
+}
+
+// ProductFormatIconComponent
+host: {
+  '[class]': '["inline-block","text-isa-neutral-900", "size-6"]',
+  'data-what': 'product-format-icon',
+  'data-which': 'shared-product-format-icon'
+}
+```
+
+**Benefits:**
+- Consistent styling without consumer configuration
+- E2E testing attributes built-in
+- Encapsulated component behavior
+
+### OnPush Change Detection
+
+`ProductFormatComponent` uses OnPush strategy:
+
+```typescript
+@Component({
+  changeDetection: ChangeDetectionStrategy.OnPush
+})
+```
+
+**Benefits:**
+- Improved performance
+- Works seamlessly with signal inputs
+- Reduces unnecessary change detection cycles
+
+### Icon Library Integration
+
+The library integrates with `@ng-icons/core` and `@isa/icons`:
+
+```typescript
+import { NgIcon, provideIcons } from '@ng-icons/core';
+import { ProductFormatIconGroup } from '@isa/icons';
+
+providers: [provideIcons(ProductFormatIconGroup)]
+```
+
+**Benefits:**
+- Centralized icon management
+- Consistent icon rendering
+- Automatic tree-shaking of unused icons
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Dynamic Icon Size** - Input for configurable icon sizes
+2. **Custom Icon Groups** - Support for additional icon sets
+3. **Tooltip Integration** - Optional tooltips with format descriptions
+4. **Format Validation** - Warning for unsupported format codes
+5. **Accessibility** - ARIA labels for screen readers
+6. **RTL Support** - Right-to-left language support
+7. **Icon Color Variants** - Theme-based color customization
+
+## Testing
+
+The library uses **Jest** with **Spectator** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test shared-product-format --skip-nx-cache
+
+# Run tests with coverage
+npx nx test shared-product-format --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test shared-product-format --watch
+```
+
+### Test Structure
+
+The library includes unit tests covering:
+
+- **Component creation** - Tests component initialization
+- **Input binding** - Tests format and formatDetail inputs
+- **Icon rendering** - Tests ProductFormatIconComponent integration
+- **Text rendering** - Tests formatDetail display
+- **E2E attributes** - Tests data-what and data-which attributes
+- **Case normalization** - Tests lowercase conversion
+
+### Example Test
+
+```typescript
+import { createComponentFactory, Spectator } from '@ngneat/spectator/jest';
+import { ProductFormatComponent } from './product-format.component';
+import { ProductFormatIconComponent } from './product-format-icon.component';
+
+describe('ProductFormatComponent', () => {
+  let spectator: Spectator<ProductFormatComponent>;
+  const createComponent = createComponentFactory({
+    component: ProductFormatComponent,
+    imports: [ProductFormatIconComponent]
+  });
+
+  beforeEach(() => {
+    spectator = createComponent({
+      props: {
+        format: 'HC',
+        formatDetail: 'Hardcover'
+      }
+    });
+  });
+
+  it('should create', () => {
+    expect(spectator.component).toBeTruthy();
+  });
+
+  it('should render ProductFormatIconComponent with correct format', () => {
+    const icon = spectator.query(ProductFormatIconComponent);
+    expect(icon).toBeTruthy();
+    expect(icon?.format()).toBe('HC');
+  });
+
+  it('should render the formatDetail text', () => {
+    expect(spectator.query('span')).toHaveText('Hardcover');
+  });
+
+  it('should set correct data attributes on host', () => {
+    const host = spectator.element;
+    expect(host).toHaveAttribute('data-what', 'product-format');
+    expect(host).toHaveAttribute('data-which', 'shared-product-format');
+  });
+});
+```
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework for components and signals
+- `@ng-icons/core` - Icon rendering engine
+- `@isa/icons` - ISA icon library with ProductFormatIconGroup
+
+### Path Alias
+
+Import from: `@isa/shared/product-format`
+
+### Exports
+
+- `ProductFormatComponent` - Combined icon and text display
+- `ProductFormatIconComponent` - Icon-only display
+
+## Best Practices
+
+### 1. Choose Appropriate Component
+
+Use the right component for your layout:
+
+```typescript
+// Good - Combined component for detailed displays
+<shared-product-format format="HC" formatDetail="Hardcover" />
+
+// Good - Icon component for compact layouts
+<shared-product-format-icon format="HC" />
+
+// Avoid - Using combined component when space is limited
+<div class="compact-list">
+  <shared-product-format format="HC" formatDetail="Hardcover" /> <!-- Too verbose -->
+</div>
+```
+
+### 2. Consistent Format Codes
+
+Use consistent format codes across your application:
+
+```typescript
+// Good - Consistent codes
+const FORMATS = {
+  HARDCOVER: 'HC',
+  PAPERBACK: 'PB',
+  EBOOK: 'EB'
+} as const;
+
+// Avoid - Inconsistent codes
+format: 'hardcover'  // Wrong - should be 'HC'
+format: 'hc'         // Works but inconsistent with uppercase convention
+```
+
+### 3. Provide Meaningful Format Details
+
+Use clear, user-friendly format descriptions:
+
+```typescript
+// Good - Clear descriptions
+<shared-product-format format="HC" formatDetail="Hardcover" />
+<shared-product-format format="AB" formatDetail="Audiobook (MP3)" />
+
+// Avoid - Technical or unclear descriptions
+<shared-product-format format="HC" formatDetail="HC Format" /> <!-- Redundant -->
+<shared-product-format format="AB" formatDetail="Audio" /> <!-- Too vague -->
+```
+
+### 4. Include E2E Attributes
+
+Add test attributes to parent containers for context:
+
+```typescript
+<div class="product-info" data-what="product-format-section">
+  <shared-product-format
+    [format]="product.format"
+    [formatDetail]="product.formatDetail"
+  />
+</div>
+```
+
+### 5. Handle Missing Format Gracefully
+
+Provide fallbacks for unknown formats:
+
+```typescript
+@Component({
+  template: `
+    @if (hasValidFormat()) {
+      <shared-product-format
+        [format]="product().format"
+        [formatDetail]="product().formatDetail"
+      />
+    } @else {
+      <span class="unknown-format">Format not available</span>
+    }
+  `
+})
+export class ProductComponent {
+  product = input.required<Product>();
+
+  hasValidFormat(): boolean {
+    const format = this.product().format;
+    return !!format && this.product().formatDetail !== undefined;
+  }
+}
+```
+
+## Performance Considerations
+
+### OnPush Change Detection
+
+The component uses OnPush strategy for optimal performance:
+- Only re-renders when inputs change
+- Minimal change detection overhead
+- Works seamlessly with signals
+
+### Icon Loading
+
+Icons are loaded from ProductFormatIconGroup:
+- Tree-shakeable - unused icons not included in bundle
+- Lazy-loaded via ng-icons
+- Cached after first render
+
+### Signal-Based Reactivity
+
+Uses computed signals for efficient updates:
+- Only recalculates when format input changes
+- No manual subscription management
+- Automatic cleanup
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/shared/product-image/README.md b/libs/shared/product-image/README.md
index da93db267..02c5ea915 100644
--- a/libs/shared/product-image/README.md
+++ b/libs/shared/product-image/README.md
@@ -1,7 +1,648 @@
-# shared-product-image
+# @isa/shared/product-image
 
-This library was generated with [Nx](https://nx.dev).
+A lightweight Angular library providing a directive and service for displaying product images from a CDN with dynamic sizing and fallback support.
 
-## Running unit tests
+## Overview
 
-Run `nx test shared-product-image` to execute the unit tests.
+The Product Image library simplifies the integration of product images throughout the ISA application by providing a declarative directive and a service for generating image URLs. It integrates with the application's configuration system to automatically fetch the CDN base URL and supports dynamic image dimensions, fallback images, and optional dummy image display.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Configuration](#configuration)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Declarative directive** - Simple `sharedProductImage` directive for img elements
+- **CDN integration** - Automatic CDN URL configuration from app config
+- **Dynamic sizing** - Configurable width and height with intelligent defaults
+- **Dummy fallback** - Optional dummy image display when product image unavailable
+- **Signal-based reactivity** - Uses Angular signals for efficient change detection
+- **Type-safe configuration** - Zod validation for CDN URL configuration
+- **Custom provider** - Override CDN URL for testing or alternative environments
+- **Standalone architecture** - Modern Angular standalone directive
+
+## Quick Start
+
+### 1. Import the Directive
+
+```typescript
+import { Component } from '@angular/core';
+import { ProductImageDirective } from '@isa/shared/product-image';
+
+@Component({
+  selector: 'app-product-list',
+  standalone: true,
+  imports: [ProductImageDirective],
+  template: `
+    <div class="product-grid">
+      @for (product of products; track product.ean) {
+        <div class="product-card">
+          <img
+            sharedProductImage
+            [ean]="product.ean"
+            [imageWidth]="300"
+            [imageHeight]="300"
+            alt="Product image"
+          />
+        </div>
+      }
+    </div>
+  `
+})
+export class ProductListComponent {
+  products = [
+    { ean: '1234567890123', name: 'Product 1' },
+    { ean: '9876543210987', name: 'Product 2' }
+  ];
+}
+```
+
+### 2. Use with Default Dimensions
+
+The directive uses sensible defaults (150x150) if dimensions are not specified:
+
+```typescript
+@Component({
+  template: `
+    <!-- Uses default 150x150 dimensions -->
+    <img sharedProductImage [ean]="productEan" alt="Product" />
+  `
+})
+export class ProductDetailComponent {
+  productEan = '1234567890123';
+}
+```
+
+### 3. Use the Service Directly
+
+For programmatic URL generation:
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { ProductImageService } from '@isa/shared/product-image';
+
+@Component({
+  selector: 'app-custom-image',
+  template: `
+    <div [style.background-image]="'url(' + imageUrl + ')'"></div>
+  `
+})
+export class CustomImageComponent {
+  #productImageService = inject(ProductImageService);
+
+  imageUrl = this.#productImageService.getImageUrl({
+    imageId: '1234567890123',
+    width: 400,
+    height: 300,
+    showDummy: true
+  });
+}
+```
+
+## Core Concepts
+
+### Image URL Structure
+
+The library generates CDN image URLs following this format:
+
+```
+{CDN_BASE_URL}/{imageId}_{width}x{height}.jpg?showDummy={showDummy}
+```
+
+**Example:**
+```
+https://cdn.example.com/1234567890123_300x300.jpg?showDummy=true
+```
+
+### Image ID (EAN)
+
+Product images are identified by their EAN (European Article Number), which serves as the `imageId` in the CDN URL structure. This ensures a consistent 1:1 mapping between products and their images.
+
+### Dynamic Sizing
+
+The library supports dynamic image dimensions to optimize for different use cases:
+
+- **Thumbnail**: 150x150 (default)
+- **Product Card**: 300x300
+- **Detail View**: 600x600
+- **Custom**: Any width/height combination
+
+The CDN automatically scales and serves the requested dimensions, improving page load performance.
+
+### Dummy Image Fallback
+
+The `showDummy` parameter controls fallback behavior:
+
+- **`true` (default)**: Display a generic placeholder when the actual product image is unavailable
+- **`false`**: Return no image (useful for progressive loading scenarios)
+
+## API Reference
+
+### ProductImageDirective
+
+A standalone directive that sets the `src` attribute of img elements to product image URLs.
+
+**Selector:** `img[sharedProductImage]`
+
+#### Inputs
+
+##### `ean` (required)
+- **Type:** `InputSignal<string>`
+- **Description:** The product's EAN number, used as the image identifier
+
+##### `imageWidth` (optional)
+- **Type:** `InputSignal<number>`
+- **Default:** `150`
+- **Description:** Desired image width in pixels
+
+##### `imageHeight` (optional)
+- **Type:** `InputSignal<number>`
+- **Default:** `150`
+- **Description:** Desired image height in pixels
+
+#### Host Bindings
+
+- **`[src]`**: Automatically binds to the computed image URL
+
+#### Example
+
+```typescript
+<img
+  sharedProductImage
+  [ean]="productEan"
+  [imageWidth]="300"
+  [imageHeight]="300"
+  alt="Product image"
+  class="rounded-lg shadow-md"
+/>
+```
+
+### ProductImageService
+
+Injectable service for generating product image URLs.
+
+**Provided in:** `'root'`
+
+#### Methods
+
+##### `getImageUrl(options): string`
+
+Generates a CDN image URL for the specified product.
+
+**Parameters:**
+- `options.imageId: string` - Product EAN (image identifier)
+- `options.width?: number` - Image width in pixels (default: 150)
+- `options.height?: number` - Image height in pixels (default: 150)
+- `options.showDummy?: boolean` - Show dummy/placeholder image if unavailable (default: true)
+
+**Returns:** `string` - Complete CDN image URL
+
+**Example:**
+```typescript
+const url = productImageService.getImageUrl({
+  imageId: '1234567890123',
+  width: 400,
+  height: 400,
+  showDummy: false
+});
+// Result: "https://cdn.example.com/1234567890123_400x400.jpg?showDummy=false"
+```
+
+#### Properties
+
+##### `imageUrl: string`
+- **Type:** `string`
+- **Description:** The base CDN URL injected from configuration
+- **Access:** `readonly`
+
+### PRODUCT_IMAGE_URL
+
+Injection token providing the CDN base URL for product images.
+
+**Type:** `InjectionToken<string>`
+
+**Default Factory:**
+```typescript
+inject(Config).get('@cdn/product-image.url', z.string().url())
+```
+
+The default implementation reads from the application's configuration service and validates the URL using Zod.
+
+### provideProductImageUrl(url)
+
+Provider function for overriding the product image CDN URL.
+
+**Parameters:**
+- `url: string` - Custom CDN base URL
+
+**Returns:** `Provider[]` - Array of providers to include in application/component providers
+
+**Use Cases:**
+- Testing with mock image server
+- Environment-specific CDN URLs
+- Development vs. production configurations
+
+**Example:**
+```typescript
+// In app.config.ts or testing setup
+import { provideProductImageUrl } from '@isa/shared/product-image';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideProductImageUrl('https://test-cdn.example.com'),
+    // other providers...
+  ]
+};
+```
+
+## Usage Examples
+
+### Product Grid with Multiple Sizes
+
+```typescript
+import { Component } from '@angular/core';
+import { ProductImageDirective } from '@isa/shared/product-image';
+
+@Component({
+  selector: 'app-product-grid',
+  standalone: true,
+  imports: [ProductImageDirective],
+  template: `
+    <div class="grid grid-cols-4 gap-4">
+      @for (product of products; track product.ean) {
+        <div class="product-card">
+          <img
+            sharedProductImage
+            [ean]="product.ean"
+            [imageWidth]="250"
+            [imageHeight]="250"
+            alt="{{ product.name }}"
+            class="w-full h-auto rounded"
+          />
+          <h3>{{ product.name }}</h3>
+        </div>
+      }
+    </div>
+  `
+})
+export class ProductGridComponent {
+  products = [
+    { ean: '1234567890123', name: 'Laptop Computer' },
+    { ean: '2345678901234', name: 'Wireless Mouse' },
+    { ean: '3456789012345', name: 'USB Cable' },
+    { ean: '4567890123456', name: 'Monitor Stand' }
+  ];
+}
+```
+
+### Thumbnail vs. Detail View
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { ProductImageDirective } from '@isa/shared/product-image';
+
+@Component({
+  selector: 'app-product-detail',
+  standalone: true,
+  imports: [ProductImageDirective],
+  template: `
+    <div class="flex gap-4">
+      <!-- Thumbnail gallery -->
+      <div class="flex flex-col gap-2">
+        @for (ean of productImages; track ean) {
+          <img
+            sharedProductImage
+            [ean]="ean"
+            [imageWidth]="100"
+            [imageHeight]="100"
+            (click)="selectedEan.set(ean)"
+            class="cursor-pointer border-2"
+            [class.border-isa-accent-500]="selectedEan() === ean"
+          />
+        }
+      </div>
+
+      <!-- Large preview -->
+      <div class="flex-1">
+        <img
+          sharedProductImage
+          [ean]="selectedEan()"
+          [imageWidth]="600"
+          [imageHeight]="600"
+          class="w-full h-auto"
+        />
+      </div>
+    </div>
+  `
+})
+export class ProductDetailComponent {
+  productImages = [
+    '1234567890123',
+    '1234567890124',
+    '1234567890125'
+  ];
+
+  selectedEan = signal(this.productImages[0]);
+}
+```
+
+### Programmatic URL Generation
+
+```typescript
+import { Component, inject, computed, signal } from '@angular/core';
+import { ProductImageService } from '@isa/shared/product-image';
+
+@Component({
+  selector: 'app-background-image',
+  template: `
+    <div
+      class="hero-section"
+      [style.background-image]="backgroundUrl()"
+    >
+      <h1>Featured Product</h1>
+    </div>
+  `,
+  styles: [`
+    .hero-section {
+      width: 100%;
+      height: 400px;
+      background-size: cover;
+      background-position: center;
+    }
+  `]
+})
+export class BackgroundImageComponent {
+  #productImageService = inject(ProductImageService);
+
+  featuredEan = signal('1234567890123');
+
+  backgroundUrl = computed(() => {
+    const url = this.#productImageService.getImageUrl({
+      imageId: this.featuredEan(),
+      width: 1920,
+      height: 600,
+      showDummy: false
+    });
+    return `url(${url})`;
+  });
+}
+```
+
+### Responsive Images with Different Sizes
+
+```typescript
+import { Component } from '@angular/core';
+import { ProductImageDirective } from '@isa/shared/product-image';
+import { breakpoint, Breakpoint } from '@isa/ui/layout';
+
+@Component({
+  selector: 'app-responsive-image',
+  standalone: true,
+  imports: [ProductImageDirective],
+  template: `
+    @if (isDesktop()) {
+      <img
+        sharedProductImage
+        [ean]="productEan"
+        [imageWidth]="600"
+        [imageHeight]="600"
+        alt="Product"
+      />
+    } @else {
+      <img
+        sharedProductImage
+        [ean]="productEan"
+        [imageWidth]="300"
+        [imageHeight]="300"
+        alt="Product"
+      />
+    }
+  `
+})
+export class ResponsiveImageComponent {
+  productEan = '1234567890123';
+  isDesktop = breakpoint([Breakpoint.Desktop, Breakpoint.DekstopL, Breakpoint.DekstopXL]);
+}
+```
+
+## Configuration
+
+### Application-Level Configuration
+
+The library integrates with `@isa/core/config` to read the CDN URL from the application configuration:
+
+```typescript
+// In your configuration file (e.g., environment.ts)
+export const environment = {
+  '@cdn/product-image.url': 'https://cdn.example.com/products'
+};
+
+// The service automatically reads this configuration
+// No additional setup required
+```
+
+### Override for Testing
+
+Use the `provideProductImageUrl` function to override the CDN URL for testing:
+
+```typescript
+// In test setup or app.config.ts
+import { provideProductImageUrl } from '@isa/shared/product-image';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideProductImageUrl('http://localhost:3000/mock-images'),
+    // other providers...
+  ]
+};
+```
+
+## Testing
+
+The library uses **Jest** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test shared-product-image --skip-nx-cache
+
+# Run tests with coverage
+npx nx test shared-product-image --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test shared-product-image --watch
+```
+
+### Test Examples
+
+#### Testing the Directive
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { Component } from '@angular/core';
+import { ProductImageDirective, provideProductImageUrl } from '@isa/shared/product-image';
+
+@Component({
+  standalone: true,
+  imports: [ProductImageDirective],
+  template: `<img sharedProductImage [ean]="ean" [imageWidth]="300" [imageHeight]="300" />`
+})
+class TestComponent {
+  ean = '1234567890123';
+}
+
+describe('ProductImageDirective', () => {
+  let fixture: ComponentFixture<TestComponent>;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      imports: [TestComponent],
+      providers: [
+        provideProductImageUrl('https://test-cdn.example.com')
+      ]
+    }).compileComponents();
+
+    fixture = TestBed.createComponent(TestComponent);
+    fixture.detectChanges();
+  });
+
+  it('should set src attribute with correct URL', () => {
+    const img = fixture.nativeElement.querySelector('img');
+    expect(img.src).toBe('https://test-cdn.example.com/1234567890123_300x300.jpg?showDummy=true');
+  });
+});
+```
+
+#### Testing the Service
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { ProductImageService, provideProductImageUrl } from '@isa/shared/product-image';
+
+describe('ProductImageService', () => {
+  let service: ProductImageService;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      providers: [
+        provideProductImageUrl('https://cdn.test.com')
+      ]
+    });
+    service = TestBed.inject(ProductImageService);
+  });
+
+  it('should generate URL with default dimensions', () => {
+    const url = service.getImageUrl({ imageId: '1234567890123' });
+    expect(url).toBe('https://cdn.test.com/1234567890123_150x150.jpg?showDummy=true');
+  });
+
+  it('should generate URL with custom dimensions', () => {
+    const url = service.getImageUrl({
+      imageId: '1234567890123',
+      width: 500,
+      height: 400,
+      showDummy: false
+    });
+    expect(url).toBe('https://cdn.test.com/1234567890123_500x400.jpg?showDummy=false');
+  });
+});
+```
+
+## Architecture Notes
+
+### Design Patterns
+
+#### Service + Directive Pattern
+The library uses a separation of concerns pattern:
+- **Service**: Pure URL generation logic, easily testable
+- **Directive**: Declarative UI integration, leverages Angular's host binding
+
+This separation allows the service to be used independently for programmatic scenarios while the directive provides a simple template-based API.
+
+#### Dependency Injection Strategy
+Uses Angular's injection token pattern with a factory default:
+
+```typescript
+export const PRODUCT_IMAGE_URL = new InjectionToken<string>('PRODUCT_IMAGE_URL', {
+  factory: () => inject(Config).get('@cdn/product-image.url', z.string().url()),
+});
+```
+
+This approach provides:
+- **Default behavior**: Automatic config integration
+- **Override capability**: Custom providers for testing
+- **Type safety**: Zod validation ensures valid URLs
+
+### Signal-Based Reactivity
+
+The directive uses Angular signals for optimal change detection:
+
+```typescript
+src = computed(() => {
+  const ean = this.ean();
+  const width = this.imageWidth();
+  const height = this.imageHeight();
+  return this.productImageService.getImageUrl({ imageId: ean, height, width });
+});
+```
+
+**Benefits:**
+- Automatic reactivity when inputs change
+- Efficient change detection (OnPush-compatible)
+- No manual subscription management needed
+
+### Host Binding Pattern
+
+The directive uses host property binding to set the `src` attribute:
+
+```typescript
+@Directive({
+  selector: 'img[sharedProductImage]',
+  host: { '[src]': 'src()' }
+})
+```
+
+This ensures the directive can only be applied to `img` elements and automatically manages the `src` attribute lifecycle.
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework
+- `@isa/core/config` - Application configuration service
+- `zod` - Schema validation for configuration
+
+### Path Alias
+
+Import from: `@isa/shared/product-image`
+
+## Performance Considerations
+
+### CDN Optimization
+- Images are served from CDN with automatic caching
+- Dynamic sizing reduces bandwidth for thumbnails and previews
+- Query parameter allows CDN to cache different image variants
+
+### Change Detection
+- Uses OnPush-compatible signal-based reactivity
+- Computed values only recalculate when inputs change
+- No unnecessary re-renders
+
+### Best Practices
+
+1. **Use appropriate dimensions**: Don't request 600x600 images for 100px thumbnails
+2. **Lazy loading**: Combine with native `loading="lazy"` or custom intersection observer
+3. **Alt text**: Always provide meaningful alt text for accessibility
+4. **Fallback handling**: Set `showDummy="false"` when implementing custom error handling
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/shared/product-router-link/README.md b/libs/shared/product-router-link/README.md
index 3501e9957..a94071013 100644
--- a/libs/shared/product-router-link/README.md
+++ b/libs/shared/product-router-link/README.md
@@ -1,7 +1,970 @@
-# shared-product-router-link
+# @isa/shared/product-router-link
 
-This library was generated with [Nx](https://nx.dev).
+An Angular library providing a customizable directive for creating product navigation links based on EAN codes with flexible URL generation strategies.
 
-## Running unit tests
+## Overview
 
-Run `nx test shared-product-router-link` to execute the unit tests.
+The Product Router Link library extends Angular's `RouterLink` to provide a declarative way of navigating to product detail pages using EAN codes. It features a pluggable URL builder system that allows applications to customize how product URLs are generated, making it adaptable to different routing strategies and application requirements.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Configuration](#configuration)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Declarative navigation** - Simple directive extending Angular's RouterLink
+- **EAN-based routing** - Automatic URL generation from product EAN codes
+- **Pluggable URL builder** - Customizable URL generation strategy via DI
+- **Async URL support** - Builder can return Promise for dynamic URL resolution
+- **Effect-based updates** - Reactive URL updates when EAN changes
+- **Type-safe configuration** - TypeScript interfaces for custom builders
+- **Cursor styling** - Automatic pointer cursor for better UX
+- **Standalone architecture** - Modern Angular standalone directive
+
+## Quick Start
+
+### 1. Basic Usage with Default Builder
+
+The library includes a default URL builder that generates product detail URLs:
+
+```typescript
+import { Component } from '@angular/core';
+import { ProductRouterLinkDirective } from '@isa/shared/product-router-link';
+
+@Component({
+  selector: 'app-product-list',
+  standalone: true,
+  imports: [ProductRouterLinkDirective],
+  template: `
+    <div class="product-grid">
+      @for (product of products; track product.ean) {
+        <div
+          sharedProductRouterLink
+          [ean]="product.ean"
+          class="product-card"
+        >
+          <h3>{{ product.name }}</h3>
+          <p>Click to view details</p>
+        </div>
+      }
+    </div>
+  `
+})
+export class ProductListComponent {
+  products = [
+    { ean: '1234567890123', name: 'Product 1' },
+    { ean: '9876543210987', name: 'Product 2' }
+  ];
+}
+```
+
+### 2. Custom URL Builder
+
+Override the default URL builder to match your routing structure:
+
+```typescript
+import { ApplicationConfig } from '@angular/core';
+import { provideProductRouterLinkBuilder } from '@isa/shared/product-router-link';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideProductRouterLinkBuilder((ean: string) => {
+      return `/products/${ean}`;
+    })
+  ]
+};
+```
+
+### 3. Async URL Builder
+
+Use async builders for dynamic URL resolution:
+
+```typescript
+import { inject } from '@angular/core';
+import { provideProductRouterLinkBuilder } from '@isa/shared/product-router-link';
+import { ProductService } from './product.service';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideProductRouterLinkBuilder(async (ean: string) => {
+      const productService = inject(ProductService);
+      const product = await productService.getProductByEan(ean);
+      return `/category/${product.categoryId}/product/${ean}`;
+    })
+  ]
+};
+```
+
+## Core Concepts
+
+### EAN-Based Navigation
+
+The directive uses EAN (European Article Number) as the primary identifier for product navigation. This ensures:
+
+- **Consistent routing**: Same EAN always links to same product
+- **SEO-friendly**: Product URLs can include EAN for search optimization
+- **API integration**: EAN directly maps to backend product identifiers
+
+### URL Builder Pattern
+
+The library uses the Strategy pattern for URL generation:
+
+```typescript
+type ProductRouterLinkBuilder = (ean: string) => PromiseLike<string> | string;
+```
+
+This allows:
+- **Customization**: Each application defines its own routing structure
+- **Flexibility**: Synchronous or asynchronous URL generation
+- **Testability**: Easy to mock and test different URL strategies
+
+### Default URL Format
+
+Without custom configuration, the default builder generates URLs in this format:
+
+```
+/kunde/{timestamp}/product/details/{ean}/ean
+```
+
+**Example:**
+```
+/kunde/1698765432000/product/details/1234567890123/ean
+```
+
+The timestamp ensures each navigation creates a new route entry, useful for certain navigation stack requirements.
+
+### Effect-Based Reactivity
+
+The directive uses Angular effects to automatically update the router link when the EAN input changes:
+
+```typescript
+urlEffect = effect(async () => {
+  const ean = this.ean();
+  if (!ean) return;
+  const url = await this.#builder(ean);
+  this.routerLink = url;
+});
+```
+
+This ensures the link is always synchronized with the current EAN value.
+
+## API Reference
+
+### ProductRouterLinkDirective
+
+A standalone directive extending Angular's `RouterLink` for EAN-based product navigation.
+
+**Selector:** `[sharedProductRouterLink]`
+
+**Extends:** `RouterLink`
+
+#### Inputs
+
+##### `ean` (required)
+- **Type:** `InputSignal<string>`
+- **Description:** The product's EAN code to navigate to
+
+#### Host Bindings
+
+- **`class`**: Automatically adds `'cursor-pointer'` for better UX
+
+#### Inherited Properties
+
+Inherits all properties from Angular's `RouterLink`:
+- `routerLink` - The dynamically generated product URL
+- `queryParams` - Optional query parameters
+- `fragment` - Optional URL fragment
+- `preserveFragment` - Whether to preserve URL fragment
+- `skipLocationChange` - Whether to skip location change
+- `replaceUrl` - Whether to replace current history entry
+- `state` - Navigation state
+
+#### Example
+
+```typescript
+<div
+  sharedProductRouterLink
+  [ean]="productEan"
+  [queryParams]="{ source: 'search' }"
+>
+  View Product Details
+</div>
+```
+
+### ProductRouterLinkBuilder
+
+Type definition for custom URL builder functions.
+
+**Type:**
+```typescript
+type ProductRouterLinkBuilder = (ean: string) => PromiseLike<string> | string;
+```
+
+**Parameters:**
+- `ean: string` - The product EAN to build a URL for
+
+**Returns:** `PromiseLike<string> | string` - The generated product URL (can be async)
+
+**Example Implementations:**
+
+```typescript
+// Synchronous builder
+const syncBuilder: ProductRouterLinkBuilder = (ean) => {
+  return `/products/${ean}`;
+};
+
+// Asynchronous builder
+const asyncBuilder: ProductRouterLinkBuilder = async (ean) => {
+  const category = await fetchCategoryForEan(ean);
+  return `/categories/${category}/products/${ean}`;
+};
+```
+
+### PRODUCT_ROUTER_LINK_BUILDER
+
+Injection token for the product router link builder function.
+
+**Type:** `InjectionToken<ProductRouterLinkBuilder>`
+
+**Default Factory:**
+```typescript
+(ean: string) => `/kunde/${Date.now()}/product/details/${ean}/ean`
+```
+
+The default implementation creates URLs with timestamps for unique navigation entries.
+
+### provideProductRouterLinkBuilder(builder)
+
+Provider function for configuring a custom product URL builder.
+
+**Parameters:**
+- `builder: ProductRouterLinkBuilder` - Custom URL builder function
+
+**Returns:** `Provider[]` - Array of providers to include in application config
+
+**Example:**
+```typescript
+import { provideProductRouterLinkBuilder } from '@isa/shared/product-router-link';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideProductRouterLinkBuilder((ean) => `/shop/product/${ean}`)
+  ]
+};
+```
+
+## Usage Examples
+
+### Product Card Navigation
+
+```typescript
+import { Component } from '@angular/core';
+import { ProductRouterLinkDirective } from '@isa/shared/product-router-link';
+import { ProductImageDirective } from '@isa/shared/product-image';
+
+@Component({
+  selector: 'app-product-card',
+  standalone: true,
+  imports: [ProductRouterLinkDirective, ProductImageDirective],
+  template: `
+    <div
+      sharedProductRouterLink
+      [ean]="product.ean"
+      class="product-card hover:shadow-lg transition-shadow"
+    >
+      <img
+        sharedProductImage
+        [ean]="product.ean"
+        [imageWidth]="300"
+        [imageHeight]="300"
+        alt="{{ product.name }}"
+      />
+      <h3 class="font-bold">{{ product.name }}</h3>
+      <p class="text-gray-600">{{ product.price | currency }}</p>
+    </div>
+  `,
+  styles: [`
+    .product-card {
+      padding: 1rem;
+      border: 1px solid #e5e7eb;
+      border-radius: 0.5rem;
+      transition: box-shadow 0.2s;
+    }
+  `]
+})
+export class ProductCardComponent {
+  @Input() product!: { ean: string; name: string; price: number };
+}
+```
+
+### Search Results with Query Parameters
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { ProductRouterLinkDirective } from '@isa/shared/product-router-link';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-search-results',
+  standalone: true,
+  imports: [ProductRouterLinkDirective],
+  template: `
+    <div class="search-results">
+      @for (result of searchResults; track result.ean) {
+        <div
+          sharedProductRouterLink
+          [ean]="result.ean"
+          [queryParams]="{ source: 'search', q: searchQuery }"
+          class="result-item"
+        >
+          <h4>{{ result.name }}</h4>
+          <p>{{ result.description }}</p>
+        </div>
+      }
+    </div>
+  `
+})
+export class SearchResultsComponent {
+  searchResults = [
+    { ean: '1234567890123', name: 'Product 1', description: 'Description 1' },
+    { ean: '2345678901234', name: 'Product 2', description: 'Description 2' }
+  ];
+
+  searchQuery = 'laptop';
+}
+```
+
+### Table Row Navigation
+
+```typescript
+import { Component } from '@angular/core';
+import { ProductRouterLinkDirective } from '@isa/shared/product-router-link';
+
+@Component({
+  selector: 'app-product-table',
+  standalone: true,
+  imports: [ProductRouterLinkDirective],
+  template: `
+    <table class="w-full">
+      <thead>
+        <tr>
+          <th>EAN</th>
+          <th>Name</th>
+          <th>Stock</th>
+          <th>Price</th>
+        </tr>
+      </thead>
+      <tbody>
+        @for (product of products; track product.ean) {
+          <tr
+            sharedProductRouterLink
+            [ean]="product.ean"
+            class="hover:bg-gray-100"
+          >
+            <td>{{ product.ean }}</td>
+            <td>{{ product.name }}</td>
+            <td>{{ product.stock }}</td>
+            <td>{{ product.price | currency }}</td>
+          </tr>
+        }
+      </tbody>
+    </table>
+  `
+})
+export class ProductTableComponent {
+  products = [
+    { ean: '1234567890123', name: 'Laptop', stock: 5, price: 999.99 },
+    { ean: '2345678901234', name: 'Mouse', stock: 50, price: 29.99 },
+    { ean: '3456789012345', name: 'Keyboard', stock: 30, price: 79.99 }
+  ];
+}
+```
+
+### Navigation with State
+
+```typescript
+import { Component } from '@angular/core';
+import { ProductRouterLinkDirective } from '@isa/shared/product-router-link';
+
+@Component({
+  selector: 'app-cart-items',
+  standalone: true,
+  imports: [ProductRouterLinkDirective],
+  template: `
+    <div class="cart-items">
+      @for (item of cartItems; track item.ean) {
+        <div
+          sharedProductRouterLink
+          [ean]="item.ean"
+          [state]="{ returnUrl: '/cart', quantity: item.quantity }"
+          class="cart-item"
+        >
+          <h4>{{ item.name }}</h4>
+          <p>Quantity: {{ item.quantity }}</p>
+          <p>Click to view details</p>
+        </div>
+      }
+    </div>
+  `
+})
+export class CartItemsComponent {
+  cartItems = [
+    { ean: '1234567890123', name: 'Product 1', quantity: 2 },
+    { ean: '2345678901234', name: 'Product 2', quantity: 1 }
+  ];
+}
+```
+
+### Dynamic EAN with Signal
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { ProductRouterLinkDirective } from '@isa/shared/product-router-link';
+
+@Component({
+  selector: 'app-related-products',
+  standalone: true,
+  imports: [ProductRouterLinkDirective],
+  template: `
+    <div class="related-products">
+      <h3>Related Products</h3>
+      @for (relatedEan of relatedEans; track relatedEan) {
+        <div
+          sharedProductRouterLink
+          [ean]="relatedEan"
+          class="related-item"
+        >
+          View Product {{ relatedEan }}
+        </div>
+      }
+    </div>
+
+    <button (click)="loadMoreRelated()">
+      Load More
+    </button>
+  `
+})
+export class RelatedProductsComponent {
+  relatedEans = ['1234567890123', '2345678901234'];
+
+  loadMoreRelated(): void {
+    this.relatedEans = [
+      ...this.relatedEans,
+      '3456789012345',
+      '4567890123456'
+    ];
+  }
+}
+```
+
+## Configuration
+
+### Application-Level Configuration
+
+Configure a custom URL builder at the application level:
+
+```typescript
+// In app.config.ts
+import { ApplicationConfig } from '@angular/core';
+import { provideProductRouterLinkBuilder } from '@isa/shared/product-router-link';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideProductRouterLinkBuilder((ean: string) => {
+      // Simple product detail route
+      return `/products/${ean}`;
+    })
+  ]
+};
+```
+
+### Feature-Specific Configuration
+
+Provide different builders for specific features or modules:
+
+```typescript
+import { Component } from '@angular/core';
+import { provideProductRouterLinkBuilder } from '@isa/shared/product-router-link';
+
+@Component({
+  selector: 'app-admin-products',
+  standalone: true,
+  providers: [
+    // Admin-specific URL builder
+    provideProductRouterLinkBuilder((ean) => {
+      return `/admin/catalog/products/${ean}/edit`;
+    })
+  ],
+  template: `...`
+})
+export class AdminProductsComponent {}
+```
+
+### Category-Based URL Builder
+
+Build URLs that include category information:
+
+```typescript
+import { inject } from '@angular/core';
+import { provideProductRouterLinkBuilder } from '@isa/shared/product-router-link';
+import { CategoryService } from './category.service';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideProductRouterLinkBuilder(async (ean: string) => {
+      const categoryService = inject(CategoryService);
+      const category = await categoryService.getCategoryByEan(ean);
+      return `/shop/${category.slug}/products/${ean}`;
+    })
+  ]
+};
+```
+
+### Multi-Tenant URL Builder
+
+Generate tenant-specific product URLs:
+
+```typescript
+import { inject } from '@angular/core';
+import { provideProductRouterLinkBuilder } from '@isa/shared/product-router-link';
+import { TenantService } from './tenant.service';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideProductRouterLinkBuilder((ean: string) => {
+      const tenantService = inject(TenantService);
+      const tenantId = tenantService.getCurrentTenantId();
+      return `/tenant/${tenantId}/products/${ean}`;
+    })
+  ]
+};
+```
+
+### Testing Configuration
+
+Override builder for testing:
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { provideProductRouterLinkBuilder } from '@isa/shared/product-router-link';
+
+describe('ProductListComponent', () => {
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      imports: [ProductListComponent],
+      providers: [
+        // Use simple URLs for testing
+        provideProductRouterLinkBuilder((ean) => `/test-products/${ean}`)
+      ]
+    }).compileComponents();
+  });
+
+  it('should navigate to correct URL', () => {
+    // Test navigation with predictable URLs
+  });
+});
+```
+
+## Testing
+
+The library uses **Jest** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test shared-product-router-link --skip-nx-cache
+
+# Run tests with coverage
+npx nx test shared-product-router-link --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test shared-product-router-link --watch
+```
+
+### Test Examples
+
+#### Testing the Directive
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { Component } from '@angular/core';
+import { Router } from '@angular/router';
+import { ProductRouterLinkDirective, provideProductRouterLinkBuilder } from '@isa/shared/product-router-link';
+
+@Component({
+  standalone: true,
+  imports: [ProductRouterLinkDirective],
+  template: `
+    <div sharedProductRouterLink [ean]="ean">Navigate</div>
+  `
+})
+class TestComponent {
+  ean = '1234567890123';
+}
+
+describe('ProductRouterLinkDirective', () => {
+  let fixture: ComponentFixture<TestComponent>;
+  let router: Router;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      imports: [TestComponent],
+      providers: [
+        provideProductRouterLinkBuilder((ean) => `/products/${ean}`)
+      ]
+    }).compileComponents();
+
+    fixture = TestBed.createComponent(TestComponent);
+    router = TestBed.inject(Router);
+    fixture.detectChanges();
+  });
+
+  it('should have cursor-pointer class', () => {
+    const element = fixture.nativeElement.querySelector('[sharedProductRouterLink]');
+    expect(element.classList.contains('cursor-pointer')).toBe(true);
+  });
+
+  it('should generate correct router link', async () => {
+    const directive = fixture.debugElement.query(
+      By.directive(ProductRouterLinkDirective)
+    ).componentInstance;
+
+    // Wait for effect to process
+    await fixture.whenStable();
+
+    expect(directive.routerLink).toBe('/products/1234567890123');
+  });
+});
+```
+
+#### Testing URL Builder
+
+```typescript
+import { ProductRouterLinkBuilder } from '@isa/shared/product-router-link';
+
+describe('Custom URL Builder', () => {
+  it('should generate category-based URLs', async () => {
+    const builder: ProductRouterLinkBuilder = (ean) => {
+      // Mock category lookup
+      const categoryMap: Record<string, string> = {
+        '1234567890123': 'electronics',
+        '2345678901234': 'books'
+      };
+      const category = categoryMap[ean] || 'general';
+      return `/category/${category}/product/${ean}`;
+    };
+
+    const url1 = await builder('1234567890123');
+    const url2 = await builder('2345678901234');
+
+    expect(url1).toBe('/category/electronics/product/1234567890123');
+    expect(url2).toBe('/category/books/product/2345678901234');
+  });
+
+  it('should handle async builders', async () => {
+    const builder: ProductRouterLinkBuilder = async (ean) => {
+      await new Promise(resolve => setTimeout(resolve, 10));
+      return `/products/${ean}`;
+    };
+
+    const url = await builder('1234567890123');
+    expect(url).toBe('/products/1234567890123');
+  });
+});
+```
+
+#### Integration Testing
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { Router } from '@angular/router';
+import { Location } from '@angular/common';
+import { ProductListComponent } from './product-list.component';
+import { provideProductRouterLinkBuilder } from '@isa/shared/product-router-link';
+
+describe('ProductListComponent Navigation', () => {
+  let fixture: ComponentFixture<ProductListComponent>;
+  let router: Router;
+  let location: Location;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      imports: [ProductListComponent],
+      providers: [
+        provideRouter([
+          { path: 'products/:ean', component: ProductDetailComponent }
+        ]),
+        provideProductRouterLinkBuilder((ean) => `/products/${ean}`)
+      ]
+    }).compileComponents();
+
+    fixture = TestBed.createComponent(ProductListComponent);
+    router = TestBed.inject(Router);
+    location = TestBed.inject(Location);
+    fixture.detectChanges();
+  });
+
+  it('should navigate to product detail when clicked', async () => {
+    const productLink = fixture.nativeElement.querySelector('[sharedProductRouterLink]');
+
+    productLink.click();
+    await fixture.whenStable();
+
+    expect(location.path()).toBe('/products/1234567890123');
+  });
+});
+```
+
+## Architecture Notes
+
+### Design Patterns
+
+#### Strategy Pattern
+The library implements the Strategy pattern for URL generation:
+
+```typescript
+// Strategy interface
+type ProductRouterLinkBuilder = (ean: string) => PromiseLike<string> | string;
+
+// Concrete strategies
+const defaultStrategy: ProductRouterLinkBuilder = (ean) =>
+  `/kunde/${Date.now()}/product/details/${ean}/ean`;
+
+const simpleStrategy: ProductRouterLinkBuilder = (ean) =>
+  `/products/${ean}`;
+
+const categoryStrategy: ProductRouterLinkBuilder = async (ean) => {
+  const category = await fetchCategory(ean);
+  return `/category/${category}/product/${ean}`;
+};
+```
+
+This enables:
+- **Flexibility**: Easy to change URL generation logic
+- **Testability**: Each strategy can be tested in isolation
+- **Reusability**: Same directive works with different strategies
+
+#### Directive Extension Pattern
+Extends Angular's `RouterLink` instead of reimplementing:
+
+```typescript
+export class ProductRouterLinkDirective extends RouterLink {
+  // Inherits all RouterLink functionality
+  // Only adds EAN-specific behavior
+}
+```
+
+**Benefits:**
+- Reuses battle-tested Angular router logic
+- Inherits all RouterLink features (query params, state, etc.)
+- Minimal code surface for bugs
+
+### Effect-Based URL Resolution
+
+Uses Angular effects for reactive URL updates:
+
+```typescript
+urlEffect = effect(async () => {
+  const ean = this.ean();
+  if (!ean) return;
+  const url = await this.#builder(ean);
+  this.routerLink = url;
+});
+```
+
+**Why Effects?**
+- Automatically runs when EAN signal changes
+- Handles both sync and async builders
+- Cleans up automatically with directive lifecycle
+
+### Dependency Injection Strategy
+
+Uses injection token with default factory:
+
+```typescript
+export const PRODUCT_ROUTER_LINK_BUILDER =
+  new InjectionToken<ProductRouterLinkBuilder>('PRODUCT_ROUTER_LINK_BUILDER', {
+    factory: () => (ean: string) =>
+      `/kunde/${Date.now()}/product/details/${ean}/ean`,
+  });
+```
+
+This provides:
+- **Default behavior**: Works out of the box
+- **Override capability**: Easy to customize per application
+- **Tree-shakeable**: Unused code can be removed
+
+### Host Class Binding
+
+Automatically adds cursor styling:
+
+```typescript
+@Directive({
+  selector: '[sharedProductRouterLink]',
+  host: {
+    class: 'cursor-pointer',
+  },
+})
+```
+
+This improves UX without requiring consumers to remember CSS classes.
+
+### Type Safety
+
+TypeScript interface ensures builder correctness:
+
+```typescript
+export type ProductRouterLinkBuilder = (
+  ean: string,
+) => PromiseLike<string> | string;
+```
+
+Prevents runtime errors from invalid builder implementations.
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework
+- `@angular/router` - Angular router for RouterLink extension
+
+### Path Alias
+
+Import from: `@isa/shared/product-router-link`
+
+### Peer Dependencies
+
+- Angular Router must be configured in the application
+- Router providers must be included in application config
+
+## Best Practices
+
+### 1. Consistent URL Structure
+
+Maintain consistent URL patterns across your application:
+
+```typescript
+// Good: Consistent structure
+provideProductRouterLinkBuilder((ean) => `/products/${ean}`)
+
+// Avoid: Inconsistent patterns
+// Some links go to /product/:ean, others to /item/:ean
+```
+
+### 2. SEO-Friendly URLs
+
+Include product slugs for better SEO:
+
+```typescript
+provideProductRouterLinkBuilder(async (ean) => {
+  const product = await fetchProduct(ean);
+  const slug = product.name.toLowerCase().replace(/\s+/g, '-');
+  return `/products/${slug}/${ean}`;
+});
+// Result: /products/wireless-mouse/1234567890123
+```
+
+### 3. Error Handling
+
+Handle missing products gracefully:
+
+```typescript
+provideProductRouterLinkBuilder(async (ean) => {
+  try {
+    const product = await fetchProduct(ean);
+    return `/products/${product.id}`;
+  } catch (error) {
+    console.error(`Product not found: ${ean}`);
+    return `/products/not-found?ean=${ean}`;
+  }
+});
+```
+
+### 4. Caching
+
+Cache URL generation for frequently accessed products:
+
+```typescript
+const urlCache = new Map<string, string>();
+
+provideProductRouterLinkBuilder(async (ean) => {
+  if (urlCache.has(ean)) {
+    return urlCache.get(ean)!;
+  }
+
+  const url = await generateUrl(ean);
+  urlCache.set(ean, url);
+  return url;
+});
+```
+
+### 5. Analytics Tracking
+
+Include tracking parameters in URLs:
+
+```typescript
+provideProductRouterLinkBuilder((ean) => {
+  const source = getTrackingSource(); // e.g., 'search', 'recommendation'
+  return `/products/${ean}?utm_source=${source}`;
+});
+```
+
+## Performance Considerations
+
+### Async Builder Performance
+
+- Async builders run on every EAN change
+- Consider caching for frequently viewed products
+- Avoid expensive operations in builder functions
+
+### Effect Cleanup
+
+- Effects automatically clean up when directive is destroyed
+- No manual subscription management needed
+- Guards against setting `routerLink` after destruction
+
+### Bundle Size
+
+- Library is small (~2KB minified)
+- Extends RouterLink, no duplicate router logic
+- Tree-shakeable with proper build configuration
+
+## Common Use Cases
+
+### E-commerce Product Navigation
+```typescript
+provideProductRouterLinkBuilder((ean) => `/shop/products/${ean}`)
+```
+
+### Admin Panel
+```typescript
+provideProductRouterLinkBuilder((ean) => `/admin/inventory/${ean}`)
+```
+
+### Multi-Language Sites
+```typescript
+provideProductRouterLinkBuilder((ean) => {
+  const lang = getCurrentLanguage();
+  return `/${lang}/products/${ean}`;
+})
+```
+
+### Marketplace with Vendors
+```typescript
+provideProductRouterLinkBuilder(async (ean) => {
+  const product = await fetchProduct(ean);
+  return `/vendors/${product.vendorId}/products/${ean}`;
+})
+```
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/ui/bullet-list/README.md b/libs/ui/bullet-list/README.md
index 11caa4493..6e4494edc 100644
--- a/libs/ui/bullet-list/README.md
+++ b/libs/ui/bullet-list/README.md
@@ -1,7 +1,503 @@
-# ui-bullet-list
+# @isa/ui/bullet-list
 
-This library was generated with [Nx](https://nx.dev).
+A lightweight bullet list component system for Angular applications supporting customizable icons and hierarchical content presentation.
 
-## Running unit tests
+## Overview
 
-Run `nx test ui-bullet-list` to execute the unit tests.
+The Bullet List library provides a pair of components (`ui-bullet-list` and `ui-bullet-list-item`) that work together to create visually consistent bullet-point lists with icon support. The system uses Angular's host-based component injection to propagate icon configuration from parent to children, enabling both uniform and customized list appearances.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Component API](#component-api)
+- [Usage Examples](#usage-examples)
+- [Styling and Customization](#styling-and-customization)
+- [Architecture Notes](#architecture-notes)
+- [Testing](#testing)
+- [Dependencies](#dependencies)
+
+## Features
+
+- **Parent-child icon inheritance** - Default icon flows from list to items
+- **Per-item icon override** - Individual items can specify custom icons
+- **Angular signals integration** - Reactive icon computation with `computed()`
+- **Standalone components** - Modern Angular architecture with explicit imports
+- **Icon library integration** - Uses `@ng-icons/core` with ISA icon set
+- **OnPush change detection** - Optimized performance
+- **Host-based injection** - Seamless parent-child communication
+- **Content projection** - Flexible content rendering via `<ng-content>`
+
+## Quick Start
+
+### 1. Import Components
+
+```typescript
+import { Component } from '@angular/core';
+import { BulletListComponent, BulletListItemComponent } from '@isa/ui/bullet-list';
+
+@Component({
+  selector: 'app-feature-list',
+  imports: [BulletListComponent, BulletListItemComponent],
+  template: `...`
+})
+export class FeatureListComponent {}
+```
+
+### 2. Basic Usage
+
+```html
+<ui-bullet-list>
+  <ui-bullet-list-item>First feature</ui-bullet-list-item>
+  <ui-bullet-list-item>Second feature</ui-bullet-list-item>
+  <ui-bullet-list-item>Third feature</ui-bullet-list-item>
+</ui-bullet-list>
+```
+
+### 3. Custom Icons
+
+```html
+<!-- Custom icon for entire list -->
+<ui-bullet-list [icon]="'isaActionCheck'">
+  <ui-bullet-list-item>Completed task</ui-bullet-list-item>
+  <ui-bullet-list-item>Another completed task</ui-bullet-list-item>
+</ui-bullet-list>
+
+<!-- Mixed icons - per-item override -->
+<ui-bullet-list>
+  <ui-bullet-list-item [icon]="'isaActionCheck'">Done</ui-bullet-list-item>
+  <ui-bullet-list-item [icon]="'isaActionClock'">In progress</ui-bullet-list-item>
+  <ui-bullet-list-item>Default icon</ui-bullet-list-item>
+</ui-bullet-list>
+```
+
+## Component API
+
+### BulletListComponent
+
+Container component for bullet list items.
+
+#### Selector
+```typescript
+'ui-bullet-list'
+```
+
+#### Inputs
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `icon` | `string` | `'isaActionChevronRight'` | Default icon name for all child items |
+
+#### Host Bindings
+- `class`: `'ui-bullet-list'` - Base CSS class for styling
+
+#### Template
+Content projection only - wraps child items:
+```html
+<ng-content></ng-content>
+```
+
+#### Providers
+Automatically provides `isaActionChevronRight` icon to the icon registry.
+
+---
+
+### BulletListItemComponent
+
+Individual item within a bullet list.
+
+#### Selector
+```typescript
+'ui-bullet-list-item'
+```
+
+#### Inputs
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `icon` | `string \| undefined` | `undefined` | Custom icon override (uses parent icon if undefined) |
+
+#### Computed Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `iconName()` | `string \| undefined` | Computed icon name - resolves to item icon or falls back to parent icon |
+
+#### Host Bindings
+- `class`: `'ui-bullet-list-item'` - Base CSS class for styling
+
+#### Template
+```html
+<ng-icon [name]="iconName()" size="1.5rem"></ng-icon>
+<ng-content></ng-content>
+```
+
+## Usage Examples
+
+### Basic Feature List
+
+```typescript
+import { Component } from '@angular/core';
+import { BulletListComponent, BulletListItemComponent } from '@isa/ui/bullet-list';
+
+@Component({
+  selector: 'app-product-features',
+  imports: [BulletListComponent, BulletListItemComponent],
+  template: `
+    <h2>Product Features</h2>
+    <ui-bullet-list>
+      <ui-bullet-list-item>Fast performance</ui-bullet-list-item>
+      <ui-bullet-list-item>Easy to use</ui-bullet-list-item>
+      <ui-bullet-list-item>Highly customizable</ui-bullet-list-item>
+    </ui-bullet-list>
+  `
+})
+export class ProductFeaturesComponent {}
+```
+
+### Custom List Icon
+
+```typescript
+@Component({
+  selector: 'app-task-list',
+  imports: [BulletListComponent, BulletListItemComponent],
+  template: `
+    <h2>Completed Tasks</h2>
+    <ui-bullet-list [icon]="'isaActionCheck'">
+      <ui-bullet-list-item>Project setup complete</ui-bullet-list-item>
+      <ui-bullet-list-item>Tests passing</ui-bullet-list-item>
+      <ui-bullet-list-item>Documentation updated</ui-bullet-list-item>
+    </ui-bullet-list>
+  `
+})
+export class TaskListComponent {}
+```
+
+### Mixed Icons with Status Indicators
+
+```typescript
+@Component({
+  selector: 'app-status-list',
+  imports: [BulletListComponent, BulletListItemComponent],
+  template: `
+    <h2>Task Status</h2>
+    <ui-bullet-list>
+      <ui-bullet-list-item [icon]="'isaActionCheck'">
+        Authentication implemented
+      </ui-bullet-list-item>
+      <ui-bullet-list-item [icon]="'isaActionClock'">
+        API integration in progress
+      </ui-bullet-list-item>
+      <ui-bullet-list-item [icon]="'isaActionWarning'">
+        Performance testing pending
+      </ui-bullet-list-item>
+    </ui-bullet-list>
+  `
+})
+export class StatusListComponent {}
+```
+
+### Dynamic Icon Selection
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { BulletListComponent, BulletListItemComponent } from '@isa/ui/bullet-list';
+
+@Component({
+  selector: 'app-dynamic-list',
+  imports: [BulletListComponent, BulletListItemComponent],
+  template: `
+    <ui-bullet-list [icon]="currentIcon()">
+      <ui-bullet-list-item>Item 1</ui-bullet-list-item>
+      <ui-bullet-list-item>Item 2</ui-bullet-list-item>
+      <ui-bullet-list-item>Item 3</ui-bullet-list-item>
+    </ui-bullet-list>
+
+    <button (click)="changeIcon()">Toggle Icon</button>
+  `
+})
+export class DynamicListComponent {
+  currentIcon = signal('isaActionChevronRight');
+
+  changeIcon() {
+    const newIcon = this.currentIcon() === 'isaActionChevronRight'
+      ? 'isaActionCheck'
+      : 'isaActionChevronRight';
+    this.currentIcon.set(newIcon);
+  }
+}
+```
+
+### Nested Content with Rich HTML
+
+```typescript
+@Component({
+  selector: 'app-rich-list',
+  imports: [BulletListComponent, BulletListItemComponent],
+  template: `
+    <ui-bullet-list>
+      <ui-bullet-list-item>
+        <strong>Bold heading:</strong> Regular text description
+      </ui-bullet-list-item>
+      <ui-bullet-list-item>
+        <a href="/docs">Link to documentation</a>
+      </ui-bullet-list-item>
+      <ui-bullet-list-item>
+        <span class="highlight">Highlighted content</span> with normal text
+      </ui-bullet-list-item>
+    </ui-bullet-list>
+  `
+})
+export class RichListComponent {}
+```
+
+### Conditional Items with Control Flow
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { BulletListComponent, BulletListItemComponent } from '@isa/ui/bullet-list';
+
+@Component({
+  selector: 'app-conditional-list',
+  imports: [BulletListComponent, BulletListItemComponent],
+  template: `
+    <ui-bullet-list>
+      <ui-bullet-list-item>Always visible</ui-bullet-list-item>
+
+      @if (showAdditional()) {
+        <ui-bullet-list-item>Conditional item 1</ui-bullet-list-item>
+        <ui-bullet-list-item>Conditional item 2</ui-bullet-list-item>
+      }
+
+      @for (item of dynamicItems(); track item.id) {
+        <ui-bullet-list-item [icon]="item.icon">
+          {{ item.text }}
+        </ui-bullet-list-item>
+      }
+    </ui-bullet-list>
+  `
+})
+export class ConditionalListComponent {
+  showAdditional = signal(true);
+  dynamicItems = signal([
+    { id: 1, text: 'Dynamic 1', icon: 'isaActionCheck' },
+    { id: 2, text: 'Dynamic 2', icon: 'isaActionClock' }
+  ]);
+}
+```
+
+## Styling and Customization
+
+### CSS Classes
+
+The components expose the following CSS classes for styling:
+
+```css
+/* List container */
+.ui-bullet-list {
+  /* Add spacing, layout, etc. */
+}
+
+/* Individual list items */
+.ui-bullet-list-item {
+  /* Style item layout */
+}
+
+/* Icon within items (via ng-icon) */
+.ui-bullet-list-item ng-icon {
+  /* Customize icon appearance */
+}
+```
+
+### Example Styling
+
+```scss
+// Custom spacing and layout
+.ui-bullet-list {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+}
+
+.ui-bullet-list-item {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.5rem;
+
+  ng-icon {
+    flex-shrink: 0;
+    margin-top: 0.125rem; // Align with text
+    color: var(--isa-accent-500);
+  }
+}
+
+// Status-specific styling
+.ui-bullet-list-item {
+  &.success ng-icon {
+    color: var(--isa-success-500);
+  }
+
+  &.warning ng-icon {
+    color: var(--isa-warning-500);
+  }
+
+  &.error ng-icon {
+    color: var(--isa-error-500);
+  }
+}
+```
+
+### Icon Size Customization
+
+The default icon size is `1.5rem`. To customize globally:
+
+```scss
+.ui-bullet-list-item ng-icon {
+  font-size: 1.25rem; // Smaller icons
+  width: 1.25rem;
+  height: 1.25rem;
+}
+```
+
+## Architecture Notes
+
+### Parent-Child Communication Pattern
+
+The library uses Angular's dependency injection with the `host` flag to enable seamless communication:
+
+```typescript
+// In BulletListItemComponent
+#bulletList = inject(BulletListComponent, { optional: true, host: true });
+```
+
+This pattern:
+- Only injects the **direct parent** `BulletListComponent`
+- Returns `null` if no parent exists (via `optional: true`)
+- Enables icon inheritance without prop drilling
+
+### Icon Resolution Logic
+
+```typescript
+iconName = computed(() => {
+  return this.icon() ?? this.#bulletList?.icon();
+});
+```
+
+Resolution order:
+1. Use item's own `icon` input if provided
+2. Fall back to parent list's `icon` input
+3. Fall back to default `'isaActionChevronRight'`
+
+### Change Detection Strategy
+
+Both components use `OnPush` change detection for optimal performance:
+- Changes only trigger when inputs change
+- Computed signals automatically track dependencies
+- No manual change detection needed
+
+### Standalone Architecture
+
+Components are fully standalone with explicit imports:
+```typescript
+imports: [NgIcon]  // BulletListItemComponent
+imports: []        // BulletListComponent (no dependencies)
+```
+
+## Testing
+
+The library uses **Vitest** with **Angular Testing Utilities** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test ui-bullet-list --skip-nx-cache
+
+# Run tests with coverage
+npx nx test ui-bullet-list --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test ui-bullet-list --watch
+```
+
+### Test Coverage
+
+The library includes comprehensive tests covering:
+
+- **Component rendering** - Verifies components render correctly
+- **Icon inheritance** - Tests parent-to-child icon propagation
+- **Icon override** - Tests per-item icon customization
+- **Content projection** - Validates ng-content rendering
+- **Host injection** - Tests optional host injection behavior
+- **Signal reactivity** - Tests computed signal updates
+
+### Example Test
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach } from 'vitest';
+import { BulletListComponent, BulletListItemComponent } from '@isa/ui/bullet-list';
+
+describe('BulletListItemComponent', () => {
+  let component: BulletListItemComponent;
+  let fixture: ComponentFixture<BulletListItemComponent>;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      imports: [BulletListItemComponent, BulletListComponent]
+    });
+    fixture = TestBed.createComponent(BulletListItemComponent);
+    component = fixture.componentInstance;
+  });
+
+  it('should use parent icon when no icon provided', () => {
+    // Arrange: Create parent list with custom icon
+    const parentFixture = TestBed.createComponent(BulletListComponent);
+    parentFixture.componentInstance.icon.set('isaActionCheck');
+
+    // Act: Create child item
+    const childFixture = TestBed.createComponent(BulletListItemComponent);
+
+    // Assert: Child should inherit parent icon
+    expect(childFixture.componentInstance.iconName()).toBe('isaActionCheck');
+  });
+
+  it('should override parent icon when icon input provided', () => {
+    // Arrange & Act
+    component.icon.set('isaActionWarning');
+    fixture.detectChanges();
+
+    // Assert
+    expect(component.iconName()).toBe('isaActionWarning');
+  });
+});
+```
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework (v20.1.2)
+- `@ng-icons/core` - Icon component library
+- `@isa/icons` - ISA icon set (provides `isaActionChevronRight`)
+
+### Path Alias
+
+Import from: `@isa/ui/bullet-list`
+
+### Peer Dependencies
+
+The components require the icon library to be properly configured at the application level. Ensure `@ng-icons/core` is installed and configured.
+
+## Best Practices
+
+1. **Consistent Icon Usage** - Use the same icon set throughout your application for visual consistency
+2. **Semantic Icons** - Choose icons that match the context (check marks for completed items, chevrons for navigation)
+3. **Accessibility** - Ensure icon meanings are clear from surrounding text
+4. **Performance** - The OnPush strategy means you can safely use these components in large lists
+5. **Content Structure** - Keep list items concise; use nested HTML for complex content
+6. **Icon Registration** - Only icons used in the list need to be registered (parent component handles default)
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/ui/buttons/README.md b/libs/ui/buttons/README.md
index e9a144464..47c08ddf1 100644
--- a/libs/ui/buttons/README.md
+++ b/libs/ui/buttons/README.md
@@ -1,7 +1,966 @@
-# ui-buttons
+# @isa/ui/buttons
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive button component library for Angular applications providing five specialized button components with consistent styling, loading states, and accessibility features.
 
-## Running unit tests
+## Overview
 
-Run `nx test ui-buttons` to execute the unit tests.
+The UI Buttons library provides a complete suite of button components for the ISA application, each optimized for specific use cases. All components leverage Angular signals for reactive state management, support customizable sizes and colors, and follow the ISA design system. The library includes standard buttons, text/link-style buttons, icon-only buttons, info/help buttons, and stateful buttons with success/error states and auto-dismiss functionality.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Styling and Customization](#styling-and-customization)
+- [Accessibility](#accessibility)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Five specialized button components** - Standard, text, icon, info, and stateful buttons
+- **Reactive signal-based state** - All inputs and computed properties use Angular signals
+- **Loading states** - Built-in pending/loading indicators with spinners
+- **Customizable sizing** - Small, medium, and large sizes for all button types
+- **Theme support** - Multiple color schemes (primary, secondary, brand, tertiary, neutral)
+- **Stateful feedback** - Success/error states with configurable auto-dismiss
+- **Disabled state handling** - Proper disabled styling and ARIA attributes
+- **Keyboard navigation** - Full keyboard accessibility with tab index support
+- **OnPush change detection** - Optimized performance with minimal re-renders
+- **No encapsulation** - View encapsulation disabled for flexible styling
+- **Animation support** - Smooth transitions for stateful button state changes
+
+## Quick Start
+
+### 1. Import Components
+
+```typescript
+import { Component } from '@angular/core';
+import {
+  ButtonComponent,
+  TextButtonComponent,
+  IconButtonComponent,
+  InfoButtonComponent,
+  StatefulButtonComponent
+} from '@isa/ui/buttons';
+
+@Component({
+  selector: 'app-my-component',
+  standalone: true,
+  imports: [
+    ButtonComponent,
+    TextButtonComponent,
+    IconButtonComponent,
+    InfoButtonComponent,
+    StatefulButtonComponent
+  ],
+  template: '...'
+})
+export class MyComponent {}
+```
+
+### 2. Use Standard Button
+
+```html
+<button uiButton color="primary" size="large" [pending]="isLoading">
+  Submit Form
+</button>
+```
+
+### 3. Use Text Button (Link Style)
+
+```html
+<button uiTextButton color="strong" (click)="handleClick()">
+  Learn More
+</button>
+```
+
+### 4. Use Icon Button
+
+```html
+<button uiIconButton
+  name="isaActionEdit"
+  color="primary"
+  size="large"
+  [pending]="isSaving">
+</button>
+```
+
+### 5. Use Info Button
+
+```html
+<button uiInfoButton [disabled]="false">
+  <ng-icon name="isaActionInfo"></ng-icon>
+</button>
+```
+
+### 6. Use Stateful Button
+
+```html
+<ui-stateful-button
+  [(state)]="buttonState"
+  defaultContent="Save Changes"
+  successContent="Changes Saved!"
+  errorContent="Save Failed"
+  errorAction="Retry"
+  color="primary"
+  [dismiss]="3000"
+  (clicked)="handleSave()"
+  (action)="handleRetry()">
+</ui-stateful-button>
+```
+
+## Core Concepts
+
+### Button Component Types
+
+The library provides five specialized button components, each optimized for specific use cases:
+
+#### 1. ButtonComponent (Standard Button)
+- **Purpose**: Primary action buttons for forms, dialogs, and main interactions
+- **Selector**: `ui-button, [uiButton]`
+- **Key Features**:
+  - Customizable size (small, medium, large)
+  - Four color themes (primary, secondary, brand, tertiary)
+  - Loading spinner overlay in pending state
+  - Preserves button dimensions during loading
+  - Disabled state support
+
+#### 2. TextButtonComponent (Link-Style Button)
+- **Purpose**: Secondary actions, navigation links, and lightweight interactions
+- **Selector**: `ui-text-button, [uiTextButton]`
+- **Key Features**:
+  - Text-based styling (no background)
+  - Three color themes (normal, strong, subtle)
+  - Pending state with inline spinner
+  - Smaller footprint than standard buttons
+
+#### 3. IconButtonComponent (Icon-Only Button)
+- **Purpose**: Compact actions, toolbar buttons, and icon-based interactions
+- **Selector**: `ui-icon-button, [uiIconButton]`
+- **Key Features**:
+  - Icon-only display with configurable icon name
+  - Five color themes (primary, secondary, brand, tertiary, neutral)
+  - Three sizes with responsive icon sizing
+  - Automatic loading icon replacement
+  - Enhanced ARIA attributes for accessibility
+
+#### 4. InfoButtonComponent (Help/Info Button)
+- **Purpose**: Help buttons, tooltips triggers, and informational actions
+- **Selector**: `ui-info-button, [uiInfoButton]`
+- **Key Features**:
+  - Fixed styling optimized for info icons
+  - Pending and disabled states
+  - Minimal visual footprint
+  - Designed for use with tooltip directives
+
+#### 5. StatefulButtonComponent (Success/Error States)
+- **Purpose**: Form submissions, save actions, and operations requiring feedback
+- **Selector**: `ui-stateful-button`
+- **Key Features**:
+  - Three states: default, success, error
+  - Configurable content for each state
+  - Auto-dismiss with configurable timeout
+  - Width animations during state transitions
+  - Optional error action button
+  - Two-way binding for state management
+
+### Signal-Based Reactivity
+
+All button components use Angular signals for reactive state management:
+
+```typescript
+// Input signals
+size = input<ButtonSize>('medium');
+color = input<ButtonColor>('primary');
+pending = input<boolean>(false);
+disabled = input<boolean>(false);
+
+// Computed signals
+sizeClass = computed(() => `ui-button__${this.size()}`);
+colorClass = computed(() => `ui-button__${this.color()}`);
+pendingClass = computed(() => this.pending() ? 'ui-button__pending' : '');
+disabledClass = computed(() => this.disabled() ? 'disabled' : '');
+```
+
+### Host Binding Pattern
+
+Components use Angular host binding for dynamic CSS classes:
+
+```typescript
+host: {
+  '[class]': '["ui-button", sizeClass(), colorClass(), pendingClass(), disabledClass()]',
+  '[tabindex]': 'tabIndex()',
+  '[disabled]': 'disabled()',
+}
+```
+
+### Loading State Handling
+
+All button components support loading states with different rendering strategies:
+
+- **Standard Button**: Overlay spinner preserving button dimensions
+- **Text Button**: Inline spinner replacing content
+- **Icon Button**: Replaces icon with loading icon
+- **Info Button**: Overlay spinner
+- **Stateful Button**: Inherits from standard button behavior
+
+## API Reference
+
+### ButtonComponent
+
+Standard button component with customizable appearance and loading state.
+
+#### Inputs
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `size` | `ButtonSize` | `'medium'` | Button size: 'small', 'medium', or 'large' |
+| `color` | `ButtonColor` | `'primary'` | Color theme: 'primary', 'secondary', 'brand', or 'tertiary' |
+| `pending` | `boolean` | `false` | Shows loading spinner when true |
+| `disabled` | `boolean` | `false` | Disables button when true |
+| `tabIndex` | `number` | `0` | Tab index for keyboard navigation |
+
+#### Example
+
+```html
+<button uiButton
+  color="brand"
+  size="large"
+  [pending]="isLoading"
+  [disabled]="!isValid"
+  (click)="handleSubmit()">
+  Submit Form
+</button>
+```
+
+### TextButtonComponent
+
+Link-style button for secondary actions and navigation.
+
+#### Inputs
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `size` | `TextButtonSize` | `'medium'` | Button size: 'small', 'medium', or 'large' |
+| `color` | `TextButtonColor` | `'normal'` | Color theme: 'normal', 'strong', or 'subtle' |
+| `pending` | `boolean` | `false` | Shows loading spinner when true |
+| `disabled` | `boolean` | `false` | Disables button when true |
+| `tabIndex` | `number` | `0` | Tab index for keyboard navigation |
+
+#### Example
+
+```html
+<button uiTextButton
+  color="strong"
+  size="medium"
+  (click)="handleCancel()">
+  Cancel
+</button>
+```
+
+### IconButtonComponent
+
+Icon-only button for compact actions and toolbars.
+
+#### Inputs
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `name` | `string` | `undefined` | Icon name from @isa/icons |
+| `size` | `IconButtonSize` | `'large'` | Button size: 'small', 'medium', or 'large' |
+| `color` | `IconButtonColor` | `'primary'` | Color theme: 'primary', 'secondary', 'brand', 'tertiary', or 'neutral' |
+| `pending` | `boolean` | `false` | Shows loading icon when true |
+| `disabled` | `boolean` | `false` | Disables button when true |
+| `tabIndex` | `number` | `0` | Tab index for keyboard navigation |
+
+#### Computed Properties
+
+- `iconName`: Returns 'isaLoading' when pending, otherwise returns the input name
+- `iconSize`: Returns computed icon size ('1rem', '1.25rem', or '1.5rem') based on button size
+
+#### Example
+
+```html
+<button uiIconButton
+  name="isaActionEdit"
+  color="primary"
+  size="large"
+  [pending]="isSaving"
+  [disabled]="!canEdit"
+  (click)="handleEdit()">
+</button>
+```
+
+### InfoButtonComponent
+
+Help/info button optimized for tooltips and informational content.
+
+#### Inputs
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `pending` | `boolean` | `false` | Shows loading spinner when true |
+| `disabled` | `boolean` | `false` | Disables button when true |
+| `tabIndex` | `number` | `0` | Tab index for keyboard navigation |
+
+#### Example
+
+```html
+<button uiInfoButton
+  [disabled]="false"
+  (click)="showHelp()">
+  <ng-icon name="isaActionInfo"></ng-icon>
+</button>
+```
+
+### StatefulButtonComponent
+
+Button with success/error states and auto-dismiss functionality.
+
+#### Inputs
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `defaultContent` | `string` | required | Content displayed in default state |
+| `successContent` | `string` | required | Content displayed in success state |
+| `errorContent` | `string` | required | Content displayed in error state |
+| `errorAction` | `string` | `undefined` | Optional action button text in error state |
+| `defaultWidth` | `string` | `'100%'` | Button width in default state |
+| `successWidth` | `string` | `'100%'` | Button width in success state |
+| `errorWidth` | `string` | `'100%'` | Button width in error state |
+| `dismiss` | `number` | `5000` | Auto-dismiss timeout in milliseconds (0 to disable) |
+| `color` | `ButtonColor` | `'primary'` | Color theme |
+| `size` | `ButtonSize` | `'medium'` | Button size |
+| `pending` | `boolean` | `false` | Shows loading spinner when true |
+| `disabled` | `boolean` | `false` | Disables button when true |
+
+#### Outputs
+
+| Output | Type | Description |
+|--------|------|-------------|
+| `clicked` | `void` | Emitted when button is clicked in default state |
+| `action` | `void` | Emitted when error action button is clicked |
+
+#### Two-Way Binding
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `state` | `StatefulButtonState` | Current state: 'default', 'success', or 'error' |
+
+#### Example
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { StatefulButtonComponent } from '@isa/ui/buttons';
+
+@Component({
+  selector: 'app-save-form',
+  standalone: true,
+  imports: [StatefulButtonComponent],
+  template: `
+    <ui-stateful-button
+      [(state)]="saveState"
+      defaultContent="Save Changes"
+      successContent="Changes Saved Successfully!"
+      errorContent="Failed to Save Changes"
+      errorAction="Retry"
+      color="primary"
+      size="large"
+      [dismiss]="3000"
+      [pending]="isSaving()"
+      (clicked)="handleSave()"
+      (action)="handleRetry()">
+    </ui-stateful-button>
+  `
+})
+export class SaveFormComponent {
+  saveState = signal<'default' | 'success' | 'error'>('default');
+  isSaving = signal(false);
+
+  async handleSave(): Promise<void> {
+    this.isSaving.set(true);
+    try {
+      await this.saveFormData();
+      this.saveState.set('success');
+    } catch (error) {
+      this.saveState.set('error');
+    } finally {
+      this.isSaving.set(false);
+    }
+  }
+
+  handleRetry(): void {
+    this.saveState.set('default');
+    this.handleSave();
+  }
+}
+```
+
+## Usage Examples
+
+### Standard Button with Loading State
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { ButtonComponent } from '@isa/ui/buttons';
+
+@Component({
+  selector: 'app-submit-form',
+  standalone: true,
+  imports: [ButtonComponent],
+  template: `
+    <button uiButton
+      color="primary"
+      size="large"
+      [pending]="isSubmitting()"
+      [disabled]="!isFormValid()"
+      (click)="handleSubmit()">
+      Submit Application
+    </button>
+  `
+})
+export class SubmitFormComponent {
+  isSubmitting = signal(false);
+  isFormValid = signal(true);
+
+  async handleSubmit(): Promise<void> {
+    this.isSubmitting.set(true);
+    try {
+      await this.submitForm();
+    } finally {
+      this.isSubmitting.set(false);
+    }
+  }
+}
+```
+
+### Text Button for Navigation
+
+```typescript
+import { Component } from '@angular/core';
+import { Router } from '@angular/router';
+import { TextButtonComponent } from '@isa/ui/buttons';
+
+@Component({
+  selector: 'app-navigation-links',
+  standalone: true,
+  imports: [TextButtonComponent],
+  template: `
+    <nav>
+      <button uiTextButton color="strong" (click)="navigateHome()">
+        Home
+      </button>
+      <button uiTextButton color="normal" (click)="navigateAbout()">
+        About
+      </button>
+      <button uiTextButton color="subtle" (click)="navigateHelp()">
+        Help
+      </button>
+    </nav>
+  `
+})
+export class NavigationLinksComponent {
+  constructor(private router: Router) {}
+
+  navigateHome(): void {
+    this.router.navigate(['/']);
+  }
+
+  navigateAbout(): void {
+    this.router.navigate(['/about']);
+  }
+
+  navigateHelp(): void {
+    this.router.navigate(['/help']);
+  }
+}
+```
+
+### Icon Button Toolbar
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { IconButtonComponent } from '@isa/ui/buttons';
+
+@Component({
+  selector: 'app-editor-toolbar',
+  standalone: true,
+  imports: [IconButtonComponent],
+  template: `
+    <div class="toolbar">
+      <button uiIconButton
+        name="isaActionEdit"
+        color="primary"
+        size="medium"
+        [disabled]="!canEdit()"
+        (click)="handleEdit()">
+      </button>
+
+      <button uiIconButton
+        name="isaActionDelete"
+        color="tertiary"
+        size="medium"
+        [disabled]="!canDelete()"
+        (click)="handleDelete()">
+      </button>
+
+      <button uiIconButton
+        name="isaActionSave"
+        color="brand"
+        size="medium"
+        [pending]="isSaving()"
+        (click)="handleSave()">
+      </button>
+    </div>
+  `
+})
+export class EditorToolbarComponent {
+  canEdit = signal(true);
+  canDelete = signal(true);
+  isSaving = signal(false);
+
+  handleEdit(): void {
+    console.log('Edit clicked');
+  }
+
+  handleDelete(): void {
+    console.log('Delete clicked');
+  }
+
+  async handleSave(): Promise<void> {
+    this.isSaving.set(true);
+    try {
+      await this.saveDocument();
+    } finally {
+      this.isSaving.set(false);
+    }
+  }
+}
+```
+
+### Mixed Button Types in Dialog
+
+```typescript
+import { Component, signal } from '@angular/core';
+import {
+  ButtonComponent,
+  TextButtonComponent,
+  IconButtonComponent
+} from '@isa/ui/buttons';
+
+@Component({
+  selector: 'app-confirmation-dialog',
+  standalone: true,
+  imports: [ButtonComponent, TextButtonComponent, IconButtonComponent],
+  template: `
+    <div class="dialog">
+      <div class="dialog-header">
+        <h2>Confirm Deletion</h2>
+        <button uiIconButton
+          name="isaActionClose"
+          color="neutral"
+          size="small"
+          (click)="handleClose()">
+        </button>
+      </div>
+
+      <div class="dialog-content">
+        <p>Are you sure you want to delete this item? This action cannot be undone.</p>
+      </div>
+
+      <div class="dialog-actions">
+        <button uiTextButton
+          color="subtle"
+          (click)="handleCancel()">
+          Cancel
+        </button>
+
+        <button uiButton
+          color="tertiary"
+          [pending]="isDeleting()"
+          (click)="handleDelete()">
+          Delete Item
+        </button>
+      </div>
+    </div>
+  `
+})
+export class ConfirmationDialogComponent {
+  isDeleting = signal(false);
+
+  async handleDelete(): Promise<void> {
+    this.isDeleting.set(true);
+    try {
+      await this.deleteItem();
+      this.handleClose();
+    } finally {
+      this.isDeleting.set(false);
+    }
+  }
+
+  handleCancel(): void {
+    this.handleClose();
+  }
+
+  handleClose(): void {
+    // Close dialog logic
+  }
+
+  private async deleteItem(): Promise<void> {
+    await new Promise(resolve => setTimeout(resolve, 1000));
+  }
+}
+```
+
+## Styling and Customization
+
+### Size Classes
+
+All button components (except InfoButton) support three sizes:
+
+```typescript
+export const ButtonSize = {
+  Small: 'small',
+  Medium: 'medium',
+  Large: 'large',
+} as const;
+```
+
+CSS classes applied: `ui-button__small`, `ui-button__medium`, `ui-button__large`
+
+### Color Themes
+
+#### Standard Button Colors
+
+```typescript
+export const ButtonColor = {
+  Primary: 'primary',    // Default blue theme
+  Secondary: 'secondary', // Gray theme
+  Brand: 'brand',        // ISA brand color
+  Tertiary: 'tertiary',  // Red/warning theme
+} as const;
+```
+
+CSS classes applied: `ui-button__primary`, `ui-button__secondary`, etc.
+
+#### Text Button Colors
+
+```typescript
+export const TextButtonColor = {
+  Normal: 'normal',   // Standard text color
+  Strong: 'strong',   // Bold/emphasized text
+  Subtle: 'subtle',   // Muted text
+} as const;
+```
+
+#### Icon Button Colors
+
+```typescript
+export const IconButtonColor = {
+  Primary: 'primary',
+  Secondary: 'secondary',
+  Brand: 'brand',
+  Tertiary: 'tertiary',
+  Neutral: 'neutral',  // Additional neutral theme
+} as const;
+```
+
+### State Classes
+
+All buttons apply these state-based classes:
+
+- **Pending**: `ui-button__pending`, `ui-text-button__pending`, `ui-info-button--pending`
+- **Disabled**: `disabled` (applied to all button types)
+
+### Custom Styling
+
+Override styles using specific class selectors:
+
+```scss
+// Custom primary button styling
+.ui-button.ui-button__primary {
+  background-color: custom-color;
+  border-radius: 8px;
+}
+
+// Custom text button hover
+.ui-text-button.ui-text-button__strong:hover {
+  text-decoration: underline;
+}
+
+// Custom icon button sizing
+.ui-icon-button.ui-icon-button__large {
+  width: 48px;
+  height: 48px;
+}
+```
+
+## Accessibility
+
+All button components implement comprehensive accessibility features:
+
+### ARIA Attributes
+
+#### Standard, Text, and Info Buttons
+- `[disabled]`: Applied via host binding
+- Proper button semantics via `<button>` element
+- Tab index support for keyboard navigation
+
+#### Icon Button (Enhanced ARIA)
+```typescript
+host: {
+  '[attr.aria-disabled]': 'disabled()',
+  '[attr.aria-label]': 'name()',        // Icon name as label
+  '[attr.aria-busy]': 'pending()',      // Loading state
+  '[attr.role]': 'pending() ? "progressbar" : "button"'
+}
+```
+
+### Keyboard Navigation
+
+All buttons support:
+- **Tab**: Focus navigation
+- **Enter/Space**: Trigger click event
+- **Custom tab index**: Configurable via `tabIndex` input
+
+### Screen Reader Support
+
+- Icon buttons include `aria-label` with icon name
+- Loading states announce via `aria-busy`
+- Disabled states properly conveyed via `aria-disabled`
+- Stateful buttons maintain role semantics during state changes
+
+## Testing
+
+The library uses **Jest** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test ui-buttons --skip-nx-cache
+
+# Run tests with coverage
+npx nx test ui-buttons --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test ui-buttons --watch
+```
+
+### Test Coverage
+
+All components include comprehensive unit tests covering:
+
+- **Input signals** - Size, color, pending, disabled states
+- **Computed properties** - CSS class generation
+- **Host bindings** - Dynamic class and attribute application
+- **Event handling** - Click events, state changes (stateful button)
+- **Loading states** - Spinner rendering and icon replacement
+- **Accessibility** - ARIA attributes and keyboard navigation
+- **State management** - Stateful button state transitions and auto-dismiss
+
+## Architecture Notes
+
+### Component Architecture
+
+The library follows a consistent architecture pattern across all button types:
+
+```
+ButtonComponent (Standalone)
+├─→ Signal-based inputs (size, color, pending, disabled, tabIndex)
+├─→ Computed properties (CSS classes)
+├─→ Host bindings (dynamic attributes and classes)
+├─→ Template (content projection + conditional spinner)
+└─→ ViewEncapsulation.None (flexible styling)
+```
+
+### Design Patterns
+
+#### 1. Host Binding for Dynamic Styling
+
+All components use host binding to apply CSS classes:
+
+```typescript
+host: {
+  '[class]': '["ui-button", sizeClass(), colorClass(), pendingClass(), disabledClass()]',
+  '[tabindex]': 'tabIndex()',
+  '[disabled]': 'disabled()',
+}
+```
+
+**Benefits**:
+- No manual DOM manipulation required
+- Reactive updates via signals
+- Type-safe class application
+- Optimized change detection
+
+#### 2. Signal-Based Reactivity
+
+Components leverage Angular signals for all reactive state:
+
+```typescript
+// Input signals
+size = input<ButtonSize>('medium');
+color = input<ButtonColor>('primary');
+pending = input<boolean>(false);
+
+// Computed signals
+sizeClass = computed(() => `ui-button__${this.size()}`);
+pendingClass = computed(() => this.pending() ? 'ui-button__pending' : '');
+```
+
+**Benefits**:
+- Fine-grained reactivity
+- Automatic dependency tracking
+- Minimal re-renders with OnPush
+- Clear data flow
+
+#### 3. ViewEncapsulation.None
+
+All components disable view encapsulation:
+
+```typescript
+encapsulation: ViewEncapsulation.None
+```
+
+**Rationale**:
+- Allows global ISA design system styles to apply
+- Enables custom theming and overrides
+- Simplifies CSS class naming (no shadow DOM)
+- Consistent with ISA application styling strategy
+
+#### 4. Content Projection
+
+Standard, text, and info buttons use content projection:
+
+```html
+<ng-content></ng-content>
+@if (pending()) {
+  <div class="ui-button__spinner-container">
+    <ng-icon name="isaLoading"></ng-icon>
+  </div>
+}
+```
+
+**Benefits**:
+- Flexible button content
+- Supports text, icons, and mixed content
+- Preserves button dimensions during loading
+
+### Stateful Button Architecture
+
+The StatefulButtonComponent uses a more complex architecture:
+
+```
+StatefulButtonComponent
+├─→ Extends ButtonComponent functionality
+├─→ State management (default, success, error)
+├─→ Auto-dismiss timer with cleanup
+├─→ Width animations via AnimationBuilder
+├─→ Effect-based state watching
+├─→ Two-way state binding with model()
+└─→ Conditional error action button
+```
+
+**Key Implementation Details**:
+
+1. **State Effect with Auto-Dismiss**:
+```typescript
+effect(() => {
+  const currentState = this.state();
+  const dismissTimeout = this.dismiss();
+
+  this.clearDismissTimer();
+
+  if (dismissTimeout && (currentState === 'success' || currentState === 'error')) {
+    this.dismissTimer = setTimeout(() => {
+      this.changeState('default');
+    }, dismissTimeout);
+  }
+});
+```
+
+2. **Width Animations**:
+```typescript
+#makeWidthAnimation(width: string): void {
+  const animation = this.#animationBuilder.build([
+    style({ width: '*' }),
+    animate('250ms', style({ width }))
+  ]);
+
+  const player = animation.create(this.buttonElement().nativeElement);
+  player.play();
+}
+```
+
+3. **Lifecycle Management**:
+```typescript
+ngOnDestroy(): void {
+  this.clearDismissTimer(); // Prevent memory leaks
+}
+```
+
+### Performance Considerations
+
+1. **OnPush Change Detection**: All components use `ChangeDetectionStrategy.OnPush` for optimal performance
+2. **Signal-Based Updates**: Computed properties only recalculate when dependencies change
+3. **Minimal Re-renders**: Host bindings update only affected attributes
+4. **Animation Performance**: StatefulButton uses AnimationBuilder for performant width transitions
+
+### Known Architectural Considerations
+
+#### 1. ViewEncapsulation Strategy (Low Priority)
+
+**Current State**:
+- All components use `ViewEncapsulation.None`
+- Relies on BEM-like class naming for style isolation
+
+**Consideration**:
+- Could enable encapsulation with CSS custom properties
+- Would require design system refactoring
+
+**Impact**: Low - current approach works well with ISA design system
+
+#### 2. Stateful Button Complexity (Medium Priority)
+
+**Current State**:
+- Combines multiple concerns (state, animations, timers)
+- Complex lifecycle management
+
+**Consideration**:
+- Could extract animation logic to separate service
+- Could use directive composition for state management
+- Timer management could be centralized
+
+**Impact**: Medium - component works well but is less maintainable than simpler buttons
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework
+- `@angular/animations` - Animations (StatefulButton only)
+- `@ng-icons/core` - Icon rendering
+- `@isa/icons` - ISA icon library (loading icon)
+
+### Optional Dependencies
+
+- `@angular/forms` - For use with reactive forms (stateful button state binding)
+
+### Path Alias
+
+Import from: `@isa/ui/buttons`
+
+### Project Configuration
+
+- **Project Name**: `ui-buttons`
+- **Prefix**: `ui`
+- **Testing**: Jest
+- **Source Root**: `libs/ui/buttons/src`
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/ui/datepicker/README.md b/libs/ui/datepicker/README.md
index 1a1418621..30171ca0d 100644
--- a/libs/ui/datepicker/README.md
+++ b/libs/ui/datepicker/README.md
@@ -1,7 +1,1252 @@
-# ui-datepicker
+# @isa/ui/datepicker
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive date range picker component library for Angular applications with calendar and month/year selection views, form integration, and robust validation.
 
-## Running unit tests
+## Overview
 
-Run `nx test ui-datepicker` to execute the unit tests.
+The UI Datepicker library provides a full-featured date range picker for the ISA application. It implements Angular's `ControlValueAccessor` interface for seamless form integration, uses signals for reactive state management, and provides calendar-based date selection with month/year navigation. The library includes dedicated validators for date bounds and range order validation, making it ideal for filtering, reporting, and data entry scenarios requiring date range inputs.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Validation](#validation)
+- [Form Integration](#form-integration)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Date range selection** - Select start and end dates with automatic ordering
+- **ControlValueAccessor integration** - Full Angular forms compatibility (reactive and template-driven)
+- **Multiple views** - Calendar view for day selection, month/year view for navigation
+- **Signal-based reactivity** - Modern Angular signals for state management
+- **Configurable bounds** - Min/max date constraints with injection tokens
+- **Auto-sorting** - Automatically orders start/end dates when user selects them
+- **Zod schema validation** - Runtime type safety with Zod schemas
+- **Custom validators** - Date bounds and range order validators for forms
+- **date-fns integration** - Comprehensive date manipulation and formatting
+- **Keyboard navigation** - Full keyboard support for accessibility
+- **OnPush change detection** - Optimized performance
+- **Extensible architecture** - Abstract base class for custom datepicker implementations
+
+## Quick Start
+
+### 1. Import Component
+
+```typescript
+import { Component } from '@angular/core';
+import { FormControl, ReactiveFormsModule } from '@angular/forms';
+import { RangeDatepickerComponent } from '@isa/ui/datepicker';
+
+@Component({
+  selector: 'app-date-filter',
+  standalone: true,
+  imports: [ReactiveFormsModule, RangeDatepickerComponent],
+  template: `
+    <ui-range-datepicker [formControl]="dateRangeControl" />
+  `
+})
+export class DateFilterComponent {
+  dateRangeControl = new FormControl<[Date?, Date?]>([undefined, undefined]);
+}
+```
+
+### 2. Use with Reactive Forms
+
+```typescript
+import { Component } from '@angular/core';
+import { FormBuilder, ReactiveFormsModule, Validators } from '@angular/forms';
+import { RangeDatepickerComponent, dateBoundsValidator, dateRangeStartStopOrderValidator } from '@isa/ui/datepicker';
+import { subMonths } from 'date-fns';
+
+@Component({
+  selector: 'app-report-filter',
+  standalone: true,
+  imports: [ReactiveFormsModule, RangeDatepickerComponent],
+  template: `
+    <form [formGroup]="filterForm">
+      <ui-range-datepicker formControlName="dateRange" />
+    </form>
+  `
+})
+export class ReportFilterComponent {
+  filterForm = this.fb.group({
+    dateRange: [
+      [undefined, undefined] as [Date?, Date?],
+      [
+        Validators.required,
+        dateRangeStartStopOrderValidator('start', 'stop')
+      ]
+    ]
+  }, {
+    validators: [dateRangeStartStopOrderValidator('dateRange', 'dateRange')]
+  });
+
+  constructor(private fb: FormBuilder) {}
+}
+```
+
+### 3. Configure Min/Max Bounds
+
+```typescript
+import { Component, Provider } from '@angular/core';
+import { RangeDatepickerComponent, UI_DATEPICKER_DEFAULT_MIN, UI_DATEPICKER_DEFAULT_MAX } from '@isa/ui/datepicker';
+import { subYears, addYears } from 'date-fns';
+
+const CUSTOM_DATEPICKER_MIN: Provider = {
+  provide: UI_DATEPICKER_DEFAULT_MIN,
+  useValue: subYears(new Date(), 10) // 10 years in the past
+};
+
+const CUSTOM_DATEPICKER_MAX: Provider = {
+  provide: UI_DATEPICKER_DEFAULT_MAX,
+  useValue: addYears(new Date(), 2) // 2 years in the future
+};
+
+@Component({
+  selector: 'app-custom-datepicker',
+  standalone: true,
+  imports: [RangeDatepickerComponent],
+  providers: [CUSTOM_DATEPICKER_MIN, CUSTOM_DATEPICKER_MAX],
+  template: `<ui-range-datepicker />`
+})
+export class CustomDatepickerComponent {}
+```
+
+### 4. Access Selected Dates
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { RangeDatepickerComponent } from '@isa/ui/datepicker';
+
+@Component({
+  selector: 'app-date-display',
+  standalone: true,
+  imports: [RangeDatepickerComponent],
+  template: `
+    <ui-range-datepicker [(ngModel)]="selectedRange" />
+
+    @if (selectedRange()[0] && selectedRange()[1]) {
+      <p>Start: {{ selectedRange()[0] | date }}</p>
+      <p>End: {{ selectedRange()[1] | date }}</p>
+    }
+  `
+})
+export class DateDisplayComponent {
+  selectedRange = signal<[Date?, Date?]>([undefined, undefined]);
+}
+```
+
+## Core Concepts
+
+### Component Architecture
+
+The datepicker library uses a multi-layer architecture:
+
+```
+RangeDatepickerComponent (User-facing)
+├─→ Extends RangeDatepicker (Business logic)
+│   └─→ Extends DatepickerBase (Forms integration)
+├─→ DatepickerViewState (View state management)
+├─→ CalendarBodyComponent (Day selection view)
+├─→ MonthYearBodyComponent (Month/year selection view)
+├─→ SelectedRangeComponent (Header with date inputs)
+└─→ SelectedMonthYearComponent (Month/year display)
+```
+
+### Date Range Value Type
+
+The library uses a tuple type for date ranges:
+
+```typescript
+export const DateRangeSchema = z.tuple([
+  z.coerce.date().optional(), // start date
+  z.coerce.date().optional(), // end date
+]);
+
+export type DateRangeValue = z.infer<typeof DateRangeSchema>;
+// Type: [Date?, Date?]
+```
+
+### Auto-Sorting Behavior
+
+When users select dates, the range automatically sorts them in ascending order:
+
+```typescript
+// User selects end date first
+datepicker.setDateRange(new Date('2024-12-31'));
+// Value: [2024-12-31, undefined]
+
+// User selects start date second
+datepicker.setDateRange(new Date('2024-01-01'));
+// Value: [2024-01-01, 2024-12-31] (automatically sorted!)
+```
+
+**Sorting Logic**:
+1. If both dates are selected, clears range and starts new selection
+2. If only end date exists, sorts new selection with existing date
+3. If only start date exists, sorts new selection with existing date
+4. Uses `date-fns` `isBefore()` for comparison
+
+### View State Management
+
+The datepicker maintains separate view state from selected value:
+
+```typescript
+export class DatepickerViewState {
+  // Currently displayed month/year in calendar
+  displayedDate = signal<Date>(new Date());
+
+  // Which view is active
+  view = signal<DatepickerView>(DatepickerView.Calendar);
+}
+```
+
+**View Types**:
+- `DatepickerView.Calendar` - Day selection grid
+- `DatepickerView.MonthYear` - Month and year selection
+
+### ControlValueAccessor Implementation
+
+The datepicker implements Angular's `ControlValueAccessor` interface:
+
+```typescript
+export abstract class DatepickerBase<TValue> implements ControlValueAccessor {
+  // Form control callbacks
+  onChange?: (value: TValue | undefined) => void;
+  onTouched?: () => void;
+
+  // Current value signal
+  value = model<TValue | undefined>();
+
+  // Form control methods
+  writeValue(obj: unknown) { /* ... */ }
+  registerOnChange(fn: typeof this.onChange) { /* ... */ }
+  registerOnTouched(fn: typeof this.onTouched) { /* ... */ }
+
+  // Abstract method for type parsing
+  abstract parseValue(value: unknown): TValue | undefined;
+}
+```
+
+### Dependency Injection Pattern
+
+Min/max bounds are configurable via injection tokens:
+
+```typescript
+// Default configuration (4 years past, 1 year future)
+export const UI_DATEPICKER_DEFAULT_MIN = new InjectionToken<DateValue | undefined>(
+  'UI_DATEPICKER_DEFAULT_MIN',
+  {
+    providedIn: 'root',
+    factory: () => subYears(new Date(), 4)
+  }
+);
+
+export const UI_DATEPICKER_DEFAULT_MAX = new InjectionToken<DateValue | undefined>(
+  'UI_DATEPICKER_DEFAULT_MAX',
+  {
+    providedIn: 'root',
+    factory: () => addYears(new Date(), 1)
+  }
+);
+
+// Usage in component
+min = input<DateValue | undefined>(inject(UI_DATEPICKER_DEFAULT_MIN));
+max = input<DateValue | undefined>(inject(UI_DATEPICKER_DEFAULT_MAX));
+```
+
+## API Reference
+
+### RangeDatepickerComponent
+
+Main component for date range selection with calendar interface.
+
+#### Selector
+
+`ui-range-datepicker`
+
+#### Inputs (Inherited from DatepickerBase)
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `min` | `DateValue \| undefined` | `subYears(today, 4)` | Minimum selectable date |
+| `max` | `DateValue \| undefined` | `addYears(today, 1)` | Maximum selectable date |
+
+#### Outputs (ControlValueAccessor)
+
+Works with Angular forms - use `formControl`, `formControlName`, or `[(ngModel)]` bindings.
+
+#### Public Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `value` | `Signal<[Date?, Date?]>` | Current selected date range |
+| `viewState` | `DatepickerViewState` | View state management service |
+
+#### Methods
+
+| Method | Signature | Description |
+|--------|-----------|-------------|
+| `setValue` | `(value?: [Date?, Date?]) => void` | Programmatically set the date range |
+| `setDateRange` | `(value: Date) => void` | Add a date to the range (auto-sorts) |
+| `parseValue` | `(value: unknown) => [Date?, Date?] \| undefined` | Parse unknown value to date range |
+| `sortRangeValuesAsc` | `(range: [Date?, Date?]) => [Date?, Date?]` | Sort dates in ascending order |
+
+#### Example
+
+```typescript
+import { Component, viewChild } from '@angular/core';
+import { RangeDatepickerComponent } from '@isa/ui/datepicker';
+
+@Component({
+  selector: 'app-datepicker-example',
+  standalone: true,
+  imports: [RangeDatepickerComponent],
+  template: `
+    <ui-range-datepicker #picker />
+    <button (click)="setLastMonth()">Last Month</button>
+    <button (click)="clearDates()">Clear</button>
+  `
+})
+export class DatepickerExampleComponent {
+  picker = viewChild.required<RangeDatepickerComponent>('picker');
+
+  setLastMonth(): void {
+    const today = new Date();
+    const lastMonth = new Date(today.getFullYear(), today.getMonth() - 1, 1);
+    const endOfLastMonth = new Date(today.getFullYear(), today.getMonth(), 0);
+
+    this.picker().setValue([lastMonth, endOfLastMonth]);
+  }
+
+  clearDates(): void {
+    this.picker().setValue([undefined, undefined]);
+  }
+}
+```
+
+### DatepickerBase<TValue>
+
+Abstract base class for creating custom datepicker implementations.
+
+#### Type Parameters
+
+- `TValue` - The type of the datepicker value (e.g., `[Date?, Date?]` for range picker)
+
+#### Abstract Methods
+
+```typescript
+abstract parseValue(value: unknown): TValue | undefined;
+```
+
+Implement this method to define how raw values are parsed into your datepicker's value type.
+
+#### Concrete Methods
+
+| Method | Description |
+|--------|-------------|
+| `setValue(value?: TValue)` | Set value with parsing and form control notification |
+| `writeValue(obj: unknown)` | ControlValueAccessor method - write value from form |
+| `registerOnChange(fn)` | ControlValueAccessor method - register change callback |
+| `registerOnTouched(fn)` | ControlValueAccessor method - register touched callback |
+
+#### Example: Custom Single Date Picker
+
+```typescript
+import { Directive } from '@angular/core';
+import { DatepickerBase } from '@isa/ui/datepicker';
+import { z } from 'zod';
+
+const SingleDateSchema = z.coerce.date().optional();
+type SingleDateValue = z.infer<typeof SingleDateSchema>;
+
+@Directive()
+export class SingleDatepicker extends DatepickerBase<SingleDateValue> {
+  parseValue(value: unknown): SingleDateValue {
+    return SingleDateSchema.parse(value);
+  }
+
+  setSingleDate(value: Date): void {
+    this.setValue(value);
+  }
+}
+```
+
+### DatepickerViewState
+
+Service managing the datepicker's view state (displayed month/year and active view).
+
+#### Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `displayedDate` | `WritableSignal<Date>` | Currently displayed month/year in calendar |
+| `view` | `WritableSignal<DatepickerView>` | Active view (Calendar or MonthYear) |
+
+#### Example
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { DatepickerViewState, DatepickerView } from '@isa/ui/datepicker';
+
+@Component({
+  selector: 'app-custom-controls',
+  template: `
+    <button (click)="showCalendar()">Calendar View</button>
+    <button (click)="showMonthYear()">Month/Year View</button>
+    <button (click)="goToToday()">Today</button>
+  `
+})
+export class CustomControlsComponent {
+  viewState = inject(DatepickerViewState);
+
+  showCalendar(): void {
+    this.viewState.view.set(DatepickerView.Calendar);
+  }
+
+  showMonthYear(): void {
+    this.viewState.view.set(DatepickerView.MonthYear);
+  }
+
+  goToToday(): void {
+    this.viewState.displayedDate.set(new Date());
+  }
+}
+```
+
+### Validators
+
+#### `dateBoundsValidator(min?, max?): ValidatorFn`
+
+Validates that a date falls within specified bounds.
+
+**Parameters**:
+- `min?: Date` - Minimum allowed date (inclusive)
+- `max?: Date` - Maximum allowed date (inclusive)
+
+**Returns**: `ValidationErrors | null`
+- `{ invalidDate: true }` - If date is invalid
+- `{ minDate: true }` - If date is before minimum
+- `{ maxDate: true }` - If date is after maximum
+- `null` - If validation passes
+
+**Example**:
+
+```typescript
+import { FormControl } from '@angular/forms';
+import { dateBoundsValidator } from '@isa/ui/datepicker';
+import { subYears, addYears } from 'date-fns';
+
+const dateControl = new FormControl<Date>(
+  new Date(),
+  [dateBoundsValidator(subYears(new Date(), 5), addYears(new Date(), 1))]
+);
+
+// Test validation
+dateControl.setValue(subYears(new Date(), 10)); // Invalid - before min
+console.log(dateControl.errors); // { minDate: true }
+```
+
+#### `dateRangeStartStopOrderValidator(startKey, stopKey): ValidatorFn`
+
+Validates that a start date is not after a stop date in a form group.
+
+**Parameters**:
+- `startKey: string` - Form control key for start date
+- `stopKey: string` - Form control key for stop date
+
+**Returns**: `ValidationErrors | null`
+- `{ startAfterStop: true }` - If start date is after stop date
+- `null` - If validation passes (or if either date is missing/invalid)
+
+**Example**:
+
+```typescript
+import { FormBuilder, Validators } from '@angular/forms';
+import { dateRangeStartStopOrderValidator } from '@isa/ui/datepicker';
+
+const form = this.fb.group({
+  startDate: [null, Validators.required],
+  endDate: [null, Validators.required]
+}, {
+  validators: [dateRangeStartStopOrderValidator('startDate', 'endDate')]
+});
+
+// Test validation
+form.patchValue({
+  startDate: new Date('2024-12-31'),
+  endDate: new Date('2024-01-01')
+});
+
+console.log(form.errors); // { startAfterStop: true }
+```
+
+## Usage Examples
+
+### Basic Date Range Selection
+
+```typescript
+import { Component } from '@angular/core';
+import { FormControl, ReactiveFormsModule } from '@angular/forms';
+import { RangeDatepickerComponent } from '@isa/ui/datepicker';
+
+@Component({
+  selector: 'app-basic-range',
+  standalone: true,
+  imports: [ReactiveFormsModule, RangeDatepickerComponent],
+  template: `
+    <div class="date-filter">
+      <label>Select Date Range:</label>
+      <ui-range-datepicker [formControl]="rangeControl" />
+
+      @if (rangeControl.value?.[0] && rangeControl.value?.[1]) {
+        <p>
+          Selected: {{ rangeControl.value[0] | date }} to {{ rangeControl.value[1] | date }}
+        </p>
+      }
+    </div>
+  `
+})
+export class BasicRangeComponent {
+  rangeControl = new FormControl<[Date?, Date?]>([undefined, undefined]);
+}
+```
+
+### Form with Validation
+
+```typescript
+import { Component } from '@angular/core';
+import { FormBuilder, ReactiveFormsModule, Validators } from '@angular/forms';
+import { RangeDatepickerComponent, dateBoundsValidator, dateRangeStartStopOrderValidator } from '@isa/ui/datepicker';
+import { subMonths, addMonths } from 'date-fns';
+
+@Component({
+  selector: 'app-validated-form',
+  standalone: true,
+  imports: [ReactiveFormsModule, RangeDatepickerComponent],
+  template: `
+    <form [formGroup]="reportForm" (ngSubmit)="generateReport()">
+      <div class="form-field">
+        <label>Report Period:</label>
+        <ui-range-datepicker formControlName="dateRange" />
+
+        @if (reportForm.get('dateRange')?.hasError('required')) {
+          <span class="error">Date range is required</span>
+        }
+        @if (reportForm.get('dateRange')?.hasError('startAfterStop')) {
+          <span class="error">Start date must be before end date</span>
+        }
+        @if (reportForm.get('dateRange')?.hasError('minDate')) {
+          <span class="error">Date must be within the last 6 months</span>
+        }
+        @if (reportForm.get('dateRange')?.hasError('maxDate')) {
+          <span class="error">Date cannot be in the future</span>
+        }
+      </div>
+
+      <button type="submit" [disabled]="!reportForm.valid">
+        Generate Report
+      </button>
+    </form>
+  `
+})
+export class ValidatedFormComponent {
+  reportForm = this.fb.group({
+    dateRange: [
+      [undefined, undefined] as [Date?, Date?],
+      [
+        Validators.required,
+        dateBoundsValidator(subMonths(new Date(), 6), new Date())
+      ]
+    ]
+  }, {
+    validators: [dateRangeStartStopOrderValidator('dateRange', 'dateRange')]
+  });
+
+  constructor(private fb: FormBuilder) {}
+
+  generateReport(): void {
+    if (this.reportForm.valid) {
+      const [start, end] = this.reportForm.value.dateRange!;
+      console.log('Generating report from', start, 'to', end);
+    }
+  }
+}
+```
+
+### Custom Min/Max Bounds
+
+```typescript
+import { Component, Provider } from '@angular/core';
+import { RangeDatepickerComponent, UI_DATEPICKER_DEFAULT_MIN, UI_DATEPICKER_DEFAULT_MAX } from '@isa/ui/datepicker';
+import { subYears, endOfYear } from 'date-fns';
+
+// Custom providers for component-specific bounds
+const FISCAL_YEAR_MIN: Provider = {
+  provide: UI_DATEPICKER_DEFAULT_MIN,
+  useValue: new Date(2020, 0, 1) // January 1, 2020
+};
+
+const FISCAL_YEAR_MAX: Provider = {
+  provide: UI_DATEPICKER_DEFAULT_MAX,
+  useValue: endOfYear(new Date()) // End of current year
+};
+
+@Component({
+  selector: 'app-fiscal-report',
+  standalone: true,
+  imports: [RangeDatepickerComponent],
+  providers: [FISCAL_YEAR_MIN, FISCAL_YEAR_MAX],
+  template: `
+    <div class="fiscal-report">
+      <h2>Fiscal Year Report</h2>
+      <p>Select dates between 2020 and end of current year</p>
+      <ui-range-datepicker />
+    </div>
+  `
+})
+export class FiscalReportComponent {}
+```
+
+### Programmatic Date Control
+
+```typescript
+import { Component, signal, viewChild } from '@angular/core';
+import { RangeDatepickerComponent } from '@isa/ui/datepicker';
+import { startOfMonth, endOfMonth, subMonths, startOfYear, endOfYear } from 'date-fns';
+
+@Component({
+  selector: 'app-quick-filters',
+  standalone: true,
+  imports: [RangeDatepickerComponent],
+  template: `
+    <div class="quick-filters">
+      <button (click)="setThisMonth()">This Month</button>
+      <button (click)="setLastMonth()">Last Month</button>
+      <button (click)="setThisYear()">This Year</button>
+      <button (click)="clearRange()">Clear</button>
+    </div>
+
+    <ui-range-datepicker #picker />
+
+    @if (selectedRange()[0] && selectedRange()[1]) {
+      <div class="selected-info">
+        <p>From: {{ selectedRange()[0] | date:'fullDate' }}</p>
+        <p>To: {{ selectedRange()[1] | date:'fullDate' }}</p>
+      </div>
+    }
+  `
+})
+export class QuickFiltersComponent {
+  picker = viewChild.required<RangeDatepickerComponent>('picker');
+  selectedRange = signal<[Date?, Date?]>([undefined, undefined]);
+
+  setThisMonth(): void {
+    const today = new Date();
+    const start = startOfMonth(today);
+    const end = endOfMonth(today);
+    this.updateRange([start, end]);
+  }
+
+  setLastMonth(): void {
+    const lastMonth = subMonths(new Date(), 1);
+    const start = startOfMonth(lastMonth);
+    const end = endOfMonth(lastMonth);
+    this.updateRange([start, end]);
+  }
+
+  setThisYear(): void {
+    const today = new Date();
+    const start = startOfYear(today);
+    const end = endOfYear(today);
+    this.updateRange([start, end]);
+  }
+
+  clearRange(): void {
+    this.updateRange([undefined, undefined]);
+  }
+
+  private updateRange(range: [Date?, Date?]): void {
+    this.picker().setValue(range);
+    this.selectedRange.set(range);
+  }
+}
+```
+
+### Integration with Backend API
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { FormBuilder, ReactiveFormsModule } from '@angular/forms';
+import { RangeDatepickerComponent } from '@isa/ui/datepicker';
+import { format } from 'date-fns';
+import { HttpClient } from '@angular/common/http';
+
+interface ReportFilters {
+  startDate: string; // ISO format
+  endDate: string;   // ISO format
+}
+
+@Component({
+  selector: 'app-api-integration',
+  standalone: true,
+  imports: [ReactiveFormsModule, RangeDatepickerComponent],
+  template: `
+    <form [formGroup]="filterForm" (ngSubmit)="loadData()">
+      <ui-range-datepicker formControlName="dateRange" />
+      <button type="submit" [disabled]="!filterForm.valid || isLoading()">
+        {{ isLoading() ? 'Loading...' : 'Load Data' }}
+      </button>
+    </form>
+
+    @if (data()) {
+      <div class="results">
+        <p>Found {{ data()?.length }} results</p>
+        <!-- Display results... -->
+      </div>
+    }
+  `
+})
+export class ApiIntegrationComponent {
+  filterForm = this.fb.group({
+    dateRange: [[undefined, undefined] as [Date?, Date?]]
+  });
+
+  isLoading = signal(false);
+  data = signal<unknown[] | null>(null);
+
+  constructor(
+    private fb: FormBuilder,
+    private http: HttpClient
+  ) {}
+
+  loadData(): void {
+    const [start, end] = this.filterForm.value.dateRange!;
+
+    if (!start || !end) return;
+
+    const filters: ReportFilters = {
+      startDate: format(start, 'yyyy-MM-dd'),
+      endDate: format(end, 'yyyy-MM-dd')
+    };
+
+    this.isLoading.set(true);
+
+    this.http.get<unknown[]>('/api/reports', { params: filters })
+      .subscribe({
+        next: (results) => {
+          this.data.set(results);
+          this.isLoading.set(false);
+        },
+        error: (error) => {
+          console.error('Failed to load data:', error);
+          this.isLoading.set(false);
+        }
+      });
+  }
+}
+```
+
+## Validation
+
+### Built-in Validators
+
+The library provides two validators for common date validation scenarios:
+
+#### 1. Date Bounds Validator
+
+Ensures a date falls within a specified range:
+
+```typescript
+import { dateBoundsValidator } from '@isa/ui/datepicker';
+import { subYears, addYears } from 'date-fns';
+
+// Allow dates within 5 years past and 2 years future
+const control = new FormControl(
+  new Date(),
+  [dateBoundsValidator(subYears(new Date(), 5), addYears(new Date(), 2))]
+);
+
+// Validation errors
+control.setValue(subYears(new Date(), 10));
+console.log(control.errors); // { minDate: true }
+
+control.setValue(addYears(new Date(), 5));
+console.log(control.errors); // { maxDate: true }
+
+control.setValue(new Date('invalid'));
+console.log(control.errors); // { invalidDate: true }
+```
+
+#### 2. Date Range Order Validator
+
+Ensures start date is not after end date:
+
+```typescript
+import { dateRangeStartStopOrderValidator } from '@isa/ui/datepicker';
+
+const form = this.fb.group({
+  startDate: [null],
+  endDate: [null]
+}, {
+  validators: [dateRangeStartStopOrderValidator('startDate', 'endDate')]
+});
+
+// Valid - start before end
+form.patchValue({
+  startDate: new Date('2024-01-01'),
+  endDate: new Date('2024-12-31')
+});
+console.log(form.errors); // null
+
+// Invalid - start after end
+form.patchValue({
+  startDate: new Date('2024-12-31'),
+  endDate: new Date('2024-01-01')
+});
+console.log(form.errors); // { startAfterStop: true }
+```
+
+### Custom Validators
+
+Create custom validators for specific business rules:
+
+```typescript
+import { AbstractControl, ValidationErrors, ValidatorFn } from '@angular/forms';
+import { isWeekend } from 'date-fns';
+
+// Validator: No weekend dates
+export function noWeekendsValidator(): ValidatorFn {
+  return (control: AbstractControl): ValidationErrors | null => {
+    const date: Date | null = control.value;
+
+    if (!date) return null;
+
+    if (isWeekend(date)) {
+      return { weekend: true };
+    }
+
+    return null;
+  };
+}
+
+// Validator: Date range must span at least N days
+export function minRangeDaysValidator(minDays: number): ValidatorFn {
+  return (group: AbstractControl): ValidationErrors | null => {
+    const start = group.get('startDate')?.value as Date | null;
+    const end = group.get('endDate')?.value as Date | null;
+
+    if (!start || !end) return null;
+
+    const daysDiff = Math.ceil((end.getTime() - start.getTime()) / (1000 * 60 * 60 * 24));
+
+    if (daysDiff < minDays) {
+      return { minRangeDays: { required: minDays, actual: daysDiff } };
+    }
+
+    return null;
+  };
+}
+
+// Usage
+const form = this.fb.group({
+  startDate: [null, [Validators.required, noWeekendsValidator()]],
+  endDate: [null, [Validators.required, noWeekendsValidator()]]
+}, {
+  validators: [
+    dateRangeStartStopOrderValidator('startDate', 'endDate'),
+    minRangeDaysValidator(7) // Minimum 7 days
+  ]
+});
+```
+
+### Error Display
+
+Display validation errors in the template:
+
+```html
+<form [formGroup]="form">
+  <ui-range-datepicker formControlName="dateRange" />
+
+  @if (form.get('dateRange')?.touched && form.get('dateRange')?.errors) {
+    <div class="validation-errors">
+      @if (form.get('dateRange')?.hasError('required')) {
+        <span class="error">Date range is required</span>
+      }
+      @if (form.get('dateRange')?.hasError('minDate')) {
+        <span class="error">Date is before minimum allowed date</span>
+      }
+      @if (form.get('dateRange')?.hasError('maxDate')) {
+        <span class="error">Date is after maximum allowed date</span>
+      }
+      @if (form.get('dateRange')?.hasError('startAfterStop')) {
+        <span class="error">Start date must be before end date</span>
+      }
+      @if (form.get('dateRange')?.hasError('invalidDate')) {
+        <span class="error">Invalid date format</span>
+      }
+    </div>
+  }
+</form>
+```
+
+## Form Integration
+
+### Reactive Forms
+
+Full integration with Angular reactive forms:
+
+```typescript
+import { Component } from '@angular/core';
+import { FormBuilder, ReactiveFormsModule, Validators } from '@angular/forms';
+import { RangeDatepickerComponent, dateRangeStartStopOrderValidator } from '@isa/ui/datepicker';
+
+@Component({
+  selector: 'app-reactive-form',
+  standalone: true,
+  imports: [ReactiveFormsModule, RangeDatepickerComponent],
+  template: `
+    <form [formGroup]="form" (ngSubmit)="onSubmit()">
+      <ui-range-datepicker formControlName="dateRange" />
+      <button type="submit">Submit</button>
+    </form>
+  `
+})
+export class ReactiveFormComponent {
+  form = this.fb.group({
+    dateRange: [
+      [undefined, undefined] as [Date?, Date?],
+      [Validators.required]
+    ]
+  }, {
+    validators: [dateRangeStartStopOrderValidator('dateRange', 'dateRange')]
+  });
+
+  constructor(private fb: FormBuilder) {}
+
+  onSubmit(): void {
+    if (this.form.valid) {
+      console.log('Selected range:', this.form.value.dateRange);
+    }
+  }
+}
+```
+
+### Template-Driven Forms
+
+Works with template-driven forms via ngModel:
+
+```html
+<form #form="ngForm" (ngSubmit)="onSubmit(form)">
+  <ui-range-datepicker
+    name="dateRange"
+    [(ngModel)]="selectedRange"
+    required>
+  </ui-range-datepicker>
+
+  <button type="submit" [disabled]="!form.valid">Submit</button>
+</form>
+```
+
+### Form Control State
+
+Access form control state and errors:
+
+```typescript
+// Get form control
+const dateRangeControl = this.form.get('dateRange');
+
+// Check validity
+console.log(dateRangeControl?.valid);
+console.log(dateRangeControl?.invalid);
+console.log(dateRangeControl?.errors);
+
+// Check state
+console.log(dateRangeControl?.touched);
+console.log(dateRangeControl?.dirty);
+console.log(dateRangeControl?.pristine);
+
+// Manually update
+dateRangeControl?.setValue([new Date(), new Date()]);
+dateRangeControl?.patchValue([new Date(), undefined]);
+dateRangeControl?.markAsTouched();
+dateRangeControl?.markAsDirty();
+```
+
+## Testing
+
+The library uses **Jest** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test ui-datepicker --skip-nx-cache
+
+# Run tests with coverage
+npx nx test ui-datepicker --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test ui-datepicker --watch
+```
+
+### Test Coverage
+
+The library includes comprehensive unit tests covering:
+
+- **Component rendering** - Calendar and month/year views
+- **Date selection** - Single date, range selection, auto-sorting
+- **Form integration** - ControlValueAccessor implementation
+- **Validators** - Date bounds and range order validation
+- **State management** - View state transitions
+- **Date bounds** - Min/max constraint enforcement
+- **Edge cases** - Invalid dates, empty values, out-of-bounds dates
+
+### Example Tests
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach } from '@jest/globals';
+import { RangeDatepickerComponent } from './range-datepicker.component';
+
+describe('RangeDatepickerComponent', () => {
+  let component: RangeDatepickerComponent;
+  let fixture: ComponentFixture<RangeDatepickerComponent>;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      imports: [RangeDatepickerComponent]
+    }).compileComponents();
+
+    fixture = TestBed.createComponent(RangeDatepickerComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+
+  it('should auto-sort date range', () => {
+    const startDate = new Date('2024-01-01');
+    const endDate = new Date('2024-12-31');
+
+    // Select end date first
+    component.setDateRange(endDate);
+    // Select start date second
+    component.setDateRange(startDate);
+
+    const value = component.value();
+    expect(value?.[0]).toEqual(startDate);
+    expect(value?.[1]).toEqual(endDate);
+  });
+
+  it('should parse date range from unknown value', () => {
+    const dateStrings = ['2024-01-01', '2024-12-31'];
+    const parsed = component.parseValue(dateStrings);
+
+    expect(parsed).toBeDefined();
+    expect(parsed?.[0]).toBeInstanceOf(Date);
+    expect(parsed?.[1]).toBeInstanceOf(Date);
+  });
+});
+```
+
+## Architecture Notes
+
+### Component Hierarchy
+
+```
+RangeDatepickerComponent
+├─→ RangeDatepicker (extends DatepickerBase<DateRangeValue>)
+│   ├─→ Implements date range logic
+│   ├─→ Auto-sorting behavior
+│   └─→ Zod schema parsing
+├─→ DatepickerBase<TValue>
+│   ├─→ ControlValueAccessor implementation
+│   ├─→ Form integration
+│   └─→ Min/max bounds management
+├─→ DatepickerViewState (DI service)
+│   ├─→ Displayed date signal
+│   └─→ Active view signal
+├─→ CalendarBodyComponent
+│   ├─→ Day grid rendering
+│   ├─→ Month navigation
+│   └─→ Date selection handling
+├─→ MonthYearBodyComponent
+│   ├─→ Month selection grid
+│   ├─→ Year selection grid
+│   └─→ Bounds filtering
+├─→ SelectedRangeComponent (header)
+│   └─→ Date input fields
+└─→ SelectedMonthYearComponent (header)
+    └─→ Month/year display
+```
+
+### Design Patterns
+
+#### 1. Abstract Base Class
+
+`DatepickerBase` provides extensibility for custom implementations:
+
+```typescript
+@Directive()
+export abstract class DatepickerBase<TValue> implements ControlValueAccessor {
+  // Common form integration
+  // Min/max bounds handling
+  // Abstract parsing method
+  abstract parseValue(value: unknown): TValue | undefined;
+}
+
+// Implementations
+export class RangeDatepicker extends DatepickerBase<DateRangeValue> { /* ... */ }
+export class SingleDatepicker extends DatepickerBase<Date | undefined> { /* ... */ }
+```
+
+**Benefits**:
+- Code reuse for form integration
+- Consistent API across datepicker types
+- Easy to create custom datepicker variants
+
+#### 2. Dependency Injection for Configuration
+
+Injection tokens allow flexible configuration:
+
+```typescript
+export const UI_DATEPICKER_DEFAULT_MIN = new InjectionToken<DateValue>(
+  'UI_DATEPICKER_DEFAULT_MIN',
+  { providedIn: 'root', factory: () => subYears(new Date(), 4) }
+);
+
+// Override per component
+providers: [
+  { provide: UI_DATEPICKER_DEFAULT_MIN, useValue: customMin }
+]
+```
+
+**Benefits**:
+- Global defaults with local overrides
+- Type-safe configuration
+- Testability (easy to mock)
+
+#### 3. Signal-Based State Management
+
+Uses Angular signals for reactive state:
+
+```typescript
+// View state
+displayedDate = signal<Date>(new Date());
+view = signal<DatepickerView>(DatepickerView.Calendar);
+
+// Component value
+value = model<DateRangeValue | undefined>();
+
+// Computed properties
+calendarDays = computed(() => {
+  const month = this.viewState.displayedDate();
+  return eachDayOfInterval(/* ... */);
+});
+```
+
+**Benefits**:
+- Fine-grained reactivity
+- Automatic dependency tracking
+- Minimal re-renders with OnPush
+
+#### 4. Zod Schema Validation
+
+Runtime type safety with Zod:
+
+```typescript
+export const DateRangeSchema = z.tuple([
+  z.coerce.date().optional(),
+  z.coerce.date().optional(),
+]);
+
+parseValue(value: unknown): DateRangeValue | undefined {
+  return DateRangeSchema.optional().parse(value);
+}
+```
+
+**Benefits**:
+- Runtime type validation
+- Type coercion (strings → dates)
+- Clear validation errors
+
+### Performance Considerations
+
+1. **OnPush Change Detection**: All components use `ChangeDetectionStrategy.OnPush`
+2. **Signal-Based Reactivity**: Computed properties only recalculate when dependencies change
+3. **date-fns Tree Shaking**: Only import needed date functions
+4. **Lazy View Rendering**: Calendar/month-year views render only when active
+
+### Known Architectural Considerations
+
+#### 1. Single Date Picker Support (Medium Priority)
+
+**Current State**:
+- Library only provides `RangeDatepicker`
+- No built-in single date picker component
+
+**Consideration**:
+- Add `SingleDatepickerComponent` extending `DatepickerBase<Date>`
+- Share calendar view components
+
+**Impact**: Medium - common use case currently requires workaround
+
+#### 2. Validator Utilities Location (Low Priority)
+
+**Current State**:
+- Validators have `TODO` comments about extracting to utils
+- Currently in library but could be shared
+
+**Consideration**:
+- Move to `@isa/utils/validators` for broader reuse
+- Keep datepicker-specific validators in library
+
+**Impact**: Low - current location is acceptable
+
+#### 3. Time Selection Support (Future Enhancement)
+
+**Current State**:
+- Date-only selection
+- No time picker functionality
+
+**Consideration**:
+- Add time selection component
+- Create `DateTimeRangePicker` variant
+
+**Impact**: Future - no current requirement
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework
+- `@angular/common` - Angular common utilities (DatePipe)
+- `@angular/forms` - Forms integration (ControlValueAccessor)
+- `date-fns` - Date manipulation and formatting
+- `zod` - Runtime type validation
+- `@ng-icons/core` - Icon rendering
+- `@isa/icons` - ISA icon library (chevrons, check icon)
+- `@isa/ui/buttons` - Button components (month/year selection)
+
+### Path Alias
+
+Import from: `@isa/ui/datepicker`
+
+### Project Configuration
+
+- **Project Name**: `ui-datepicker`
+- **Prefix**: `ui`
+- **Testing**: Jest
+- **Source Root**: `libs/ui/datepicker/src`
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/ui/dialog/README.md b/libs/ui/dialog/README.md
index 7dff27193..fe535c683 100644
--- a/libs/ui/dialog/README.md
+++ b/libs/ui/dialog/README.md
@@ -1,7 +1,1013 @@
-# ui-dialog
+# @isa/ui/dialog
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive dialog system for Angular applications built on Angular CDK Dialog with preset components for common use cases.
 
-## Running unit tests
+## Overview
 
-Run `nx test ui-dialog` to execute the unit tests.
+The Dialog library provides a flexible, type-safe dialog system with five pre-built dialog components covering common scenarios: messages, confirmations, text input, number input, and feedback. Built on Angular CDK Dialog, it offers a simple injection-based API, customizable styling, backdrop control, and full TypeScript support for data and result types.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Dialog Presets](#dialog-presets)
+- [Advanced Usage](#advanced-usage)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **5 preset dialog types** - Message, Confirmation, TextInput, NumberInput, Feedback
+- **Type-safe API** - Full TypeScript support for data and result types
+- **Injection-based API** - Use `injectDialog()` in component constructors or dependency injection
+- **CDK Dialog foundation** - Built on @angular/cdk/dialog for robust dialog management
+- **Customizable appearance** - Control title, width, height, backdrop, and CSS classes
+- **Auto-close support** - Optional automatic dismiss for feedback dialogs
+- **Form validation** - Built-in validation support for input dialogs
+- **Flexible return types** - Type-safe result handling with DialogRef
+- **Backdrop control** - Enable/disable backdrop clicks to close
+- **Custom content** - Extend base components for custom dialog implementations
+
+## Quick Start
+
+### 1. Import and Inject Dialog
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { injectMessageDialog } from '@isa/ui/dialog';
+
+@Component({
+  selector: 'app-my-component',
+  template: `<button (click)="showMessage()">Show Message</button>`
+})
+export class MyComponent {
+  #openMessageDialog = injectMessageDialog();
+
+  showMessage() {
+    this.#openMessageDialog({
+      title: 'Information',
+      data: {
+        message: 'Operation completed successfully!'
+      }
+    });
+  }
+}
+```
+
+### 2. Confirmation Dialog
+
+```typescript
+import { injectConfirmationDialog } from '@isa/ui/dialog';
+
+@Component({
+  selector: 'app-delete-button',
+  template: `<button (click)="confirmDelete()">Delete</button>`
+})
+export class DeleteButtonComponent {
+  #openConfirmDialog = injectConfirmationDialog();
+
+  async confirmDelete() {
+    const result = await this.#openConfirmDialog({
+      title: 'Confirm Deletion',
+      data: {
+        message: 'Are you sure you want to delete this item?',
+        confirmText: 'Delete',
+        closeText: 'Cancel'
+      }
+    }).closed.toPromise();
+
+    if (result?.confirmed) {
+      console.log('User confirmed deletion');
+      // Perform deletion
+    }
+  }
+}
+```
+
+### 3. Text Input Dialog
+
+```typescript
+import { injectTextInputDialog } from '@isa/ui/dialog';
+import { Validators } from '@angular/forms';
+
+@Component({
+  selector: 'app-rename-dialog',
+  template: `<button (click)="renameItem()">Rename</button>`
+})
+export class RenameDialogComponent {
+  #openTextInputDialog = injectTextInputDialog();
+
+  async renameItem() {
+    const result = await this.#openTextInputDialog({
+      title: 'Rename Item',
+      data: {
+        message: 'Enter a new name for this item:',
+        inputLabel: 'Name',
+        inputDefaultValue: 'Current Name',
+        inputValidation: [
+          {
+            errorKey: 'required',
+            inputValidator: Validators.required,
+            errorText: 'Name is required'
+          },
+          {
+            errorKey: 'minlength',
+            inputValidator: Validators.minLength(3),
+            errorText: 'Name must be at least 3 characters'
+          }
+        ],
+        confirmText: 'Save',
+        closeText: 'Cancel'
+      }
+    }).closed.toPromise();
+
+    if (result?.inputValue) {
+      console.log('New name:', result.inputValue);
+      // Update item name
+    }
+  }
+}
+```
+
+## Core Concepts
+
+### Dialog System Architecture
+
+The library consists of three layers:
+
+#### 1. Base Components
+- **DialogComponent** - Container shell for all dialogs
+- **DialogContentDirective** - Base class for dialog content components
+
+#### 2. Preset Components
+- **MessageDialogComponent** - Simple informational messages
+- **ConfirmationDialogComponent** - Yes/No confirmations
+- **TextInputDialogComponent** - Text input with validation
+- **NumberInputDialogComponent** - Numeric input with validation
+- **FeedbackDialogComponent** - Success feedback with auto-close
+- **FeedbackErrorDialogComponent** - Error feedback
+
+#### 3. Injection API
+- **injectDialog()** - Generic dialog injector factory
+- **injectMessageDialog()** - Pre-configured message dialog
+- **injectConfirmationDialog()** - Pre-configured confirmation dialog
+- **injectTextInputDialog()** - Pre-configured text input dialog
+- **injectNumberInputDialog()** - Pre-configured number input dialog
+- **injectFeedbackDialog()** - Pre-configured feedback dialog
+- **injectFeedbackErrorDialog()** - Pre-configured error feedback dialog
+
+### Type-Safe Data and Results
+
+Each dialog type is strongly typed for both input data and return value:
+
+```typescript
+// Message Dialog
+interface MessageDialogData {
+  message: string;
+  closeText?: string;
+}
+// Returns: void
+
+// Confirmation Dialog
+interface ConfirmationDialogData {
+  message: string;
+  confirmText?: string;
+  closeText?: string;
+}
+interface ConfirmationDialogResult {
+  confirmed: boolean;
+}
+
+// Text Input Dialog
+interface TextInputDialogData {
+  message: string;
+  inputLabel?: string;
+  inputDefaultValue?: string;
+  inputValidation?: TextInputValidation[];
+  confirmText?: string;
+  closeText?: string;
+}
+interface TextInputDialogResult {
+  inputValue?: string;
+}
+
+// Number Input Dialog
+interface NumberInputDialogData {
+  message: string;
+  subMessage?: string;
+  subMessageValue?: string;
+  inputLabel?: string;
+  inputValue?: number;
+  inputDefaultValue?: number;
+  inputValidation?: NumberInputValidation[];
+  confirmText?: string;
+  closeText?: string;
+}
+interface NumberInputDialogResult {
+  inputValue?: number;
+}
+
+// Feedback Dialog
+interface FeedbackDialogData {
+  message: string;
+  autoClose?: boolean;
+  autoCloseDelay?: number;
+}
+// Returns: void
+```
+
+### Dialog Options
+
+Common options available for all dialogs:
+
+```typescript
+interface InjectDialogOptions {
+  title?: string;              // Dialog title
+  displayClose?: boolean;      // Show close (X) button (default: false)
+  classList?: string[];        // Additional CSS classes
+  width?: string;              // Fixed width
+  height?: string;             // Fixed height
+  minWidth?: string;           // Minimum width (default: '30rem')
+  maxWidth?: string;           // Maximum width
+  minHeight?: string;          // Minimum height
+  maxHeight?: string;          // Maximum height
+  hasBackdrop?: boolean;       // Show backdrop (default: true)
+  disableClose?: boolean;      // Disable backdrop click to close (default: true)
+}
+```
+
+## API Reference
+
+### injectDialog()
+
+Generic factory function for creating custom dialogs.
+
+**Type Parameters:**
+- `C extends DialogContentDirective<D, R>` - Dialog content component type
+- `D` - Input data type (inferred from component)
+- `R` - Result type (inferred from component)
+
+**Parameters:**
+- `componentType: ComponentType<C>` - The dialog content component class
+- `injectOptions?: InjectDialogOptions` - Default options for the dialog
+
+**Returns:** Function `(openOptions?) => DialogRef<R>`
+
+**Usage:**
+```typescript
+import { injectDialog } from '@isa/ui/dialog';
+import { MyCustomDialogComponent } from './my-custom-dialog.component';
+
+@Component({...})
+export class MyComponent {
+  #openCustomDialog = injectDialog(MyCustomDialogComponent, {
+    title: 'Custom Dialog',
+    width: '600px'
+  });
+
+  openDialog() {
+    const dialogRef = this.#openCustomDialog({
+      data: { /* custom data */ }
+    });
+
+    dialogRef.closed.subscribe(result => {
+      console.log('Dialog closed with result:', result);
+    });
+  }
+}
+```
+
+---
+
+### injectMessageDialog()
+
+Pre-configured message dialog injector.
+
+**Returns:** Function `(options?) => DialogRef<void>`
+
+**Usage:**
+```typescript
+#openMessageDialog = injectMessageDialog();
+
+showInfo() {
+  this.#openMessageDialog({
+    title: 'Information',
+    data: {
+      message: 'This is an informational message.',
+      closeText: 'OK'
+    }
+  });
+}
+```
+
+---
+
+### injectConfirmationDialog()
+
+Pre-configured confirmation dialog injector.
+
+**Parameters:**
+- `options?: OpenDialogOptions<ConfirmationDialogData>` - Optional default options
+
+**Returns:** Function `(options?) => DialogRef<ConfirmationDialogResult>`
+
+**Usage:**
+```typescript
+#openConfirmDialog = injectConfirmationDialog();
+
+async confirmAction() {
+  const result = await this.#openConfirmDialog({
+    title: 'Confirm Action',
+    data: {
+      message: 'Are you sure?',
+      confirmText: 'Yes',
+      closeText: 'No'
+    }
+  }).closed.toPromise();
+
+  return result?.confirmed ?? false;
+}
+```
+
+---
+
+### injectTextInputDialog()
+
+Pre-configured text input dialog injector.
+
+**Returns:** Function `(options?) => DialogRef<TextInputDialogResult>`
+
+**Usage:**
+```typescript
+#openTextInputDialog = injectTextInputDialog();
+
+async getTextInput() {
+  const result = await this.#openTextInputDialog({
+    title: 'Enter Value',
+    data: {
+      message: 'Please enter a value:',
+      inputLabel: 'Value',
+      inputDefaultValue: '',
+      inputValidation: [
+        {
+          errorKey: 'required',
+          inputValidator: Validators.required,
+          errorText: 'This field is required'
+        }
+      ]
+    }
+  }).closed.toPromise();
+
+  return result?.inputValue;
+}
+```
+
+---
+
+### injectNumberInputDialog()
+
+Pre-configured number input dialog injector.
+
+**Returns:** Function `(options?) => DialogRef<NumberInputDialogResult>`
+
+**Usage:**
+```typescript
+#openNumberInputDialog = injectNumberInputDialog();
+
+async getQuantity() {
+  const result = await this.#openNumberInputDialog({
+    title: 'Enter Quantity',
+    data: {
+      message: 'How many items would you like?',
+      inputLabel: 'Quantity',
+      inputDefaultValue: 1,
+      inputValidation: [
+        {
+          errorKey: 'min',
+          inputValidator: Validators.min(1),
+          errorText: 'Minimum quantity is 1'
+        },
+        {
+          errorKey: 'max',
+          inputValidator: Validators.max(100),
+          errorText: 'Maximum quantity is 100'
+        }
+      ]
+    }
+  }).closed.toPromise();
+
+  return result?.inputValue ?? 1;
+}
+```
+
+---
+
+### injectFeedbackDialog()
+
+Pre-configured feedback dialog injector with auto-close support.
+
+**Parameters:**
+- `options?: OpenDialogOptions<FeedbackDialogData>` - Optional default options
+
+**Returns:** Function `(options?) => DialogRef<void>`
+
+**Default Options:**
+- `disableClose: false` - Allows backdrop click to close
+- `minWidth: '20rem'` - Compact size for feedback
+- `classList: ['gap-0']` - Removes default spacing
+
+**Usage:**
+```typescript
+#openFeedbackDialog = injectFeedbackDialog();
+
+showSuccess() {
+  this.#openFeedbackDialog({
+    data: {
+      message: 'Changes saved successfully!',
+      autoClose: true,
+      autoCloseDelay: 1500
+    }
+  });
+}
+```
+
+---
+
+### injectFeedbackErrorDialog()
+
+Pre-configured error feedback dialog injector.
+
+**Parameters:**
+- `options?: OpenDialogOptions<FeedbackErrorDialogData>` - Optional default options
+
+**Returns:** Function `(options?) => DialogRef<void>`
+
+**Usage:**
+```typescript
+#openErrorDialog = injectFeedbackErrorDialog();
+
+showError(error: Error) {
+  this.#openErrorDialog({
+    data: {
+      message: `An error occurred: ${error.message}`
+    }
+  });
+}
+```
+
+## Usage Examples
+
+### Basic Message Dialog
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { injectMessageDialog } from '@isa/ui/dialog';
+
+@Component({
+  selector: 'app-welcome',
+  template: `<button (click)="showWelcome()">Show Welcome</button>`
+})
+export class WelcomeComponent {
+  #openMessageDialog = injectMessageDialog();
+
+  showWelcome() {
+    this.#openMessageDialog({
+      title: 'Welcome!',
+      displayClose: true,
+      data: {
+        message: 'Welcome to our application. Click OK to continue.',
+        closeText: 'OK'
+      }
+    });
+  }
+}
+```
+
+### Confirmation with Custom Styling
+
+```typescript
+import { Component } from '@angular/core';
+import { injectConfirmationDialog } from '@isa/ui/dialog';
+
+@Component({
+  selector: 'app-dangerous-action',
+  template: `<button (click)="performDangerousAction()">Delete All</button>`
+})
+export class DangerousActionComponent {
+  #openConfirmDialog = injectConfirmationDialog({
+    classList: ['dialog-danger'],
+    width: '500px'
+  });
+
+  async performDangerousAction() {
+    const result = await this.#openConfirmDialog({
+      title: 'Warning!',
+      data: {
+        message: 'This action cannot be undone. Delete all items?',
+        confirmText: 'Delete Everything',
+        closeText: 'Cancel'
+      }
+    }).closed.toPromise();
+
+    if (result?.confirmed) {
+      // Perform dangerous action
+      console.log('User confirmed dangerous action');
+    }
+  }
+}
+```
+
+### Text Input with Complex Validation
+
+```typescript
+import { Component } from '@angular/core';
+import { injectTextInputDialog } from '@isa/ui/dialog';
+import { Validators } from '@angular/forms';
+
+@Component({
+  selector: 'app-email-form',
+  template: `<button (click)="getEmail()">Enter Email</button>`
+})
+export class EmailFormComponent {
+  #openTextInputDialog = injectTextInputDialog();
+
+  async getEmail() {
+    const emailPattern = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
+
+    const result = await this.#openTextInputDialog({
+      title: 'Email Address',
+      data: {
+        message: 'Please enter your email address:',
+        inputLabel: 'Email',
+        inputDefaultValue: '',
+        inputValidation: [
+          {
+            errorKey: 'required',
+            inputValidator: Validators.required,
+            errorText: 'Email is required'
+          },
+          {
+            errorKey: 'email',
+            inputValidator: Validators.email,
+            errorText: 'Invalid email format'
+          },
+          {
+            errorKey: 'pattern',
+            inputValidator: Validators.pattern(emailPattern),
+            errorText: 'Email must be valid'
+          }
+        ],
+        confirmText: 'Submit',
+        closeText: 'Cancel'
+      }
+    }).closed.toPromise();
+
+    if (result?.inputValue) {
+      console.log('Email entered:', result.inputValue);
+      // Process email
+    }
+  }
+}
+```
+
+### Number Input for Quantity
+
+```typescript
+import { Component } from '@angular/core';
+import { injectNumberInputDialog } from '@isa/ui/dialog';
+import { Validators } from '@angular/forms';
+
+@Component({
+  selector: 'app-order-quantity',
+  template: `<button (click)="selectQuantity()">Select Quantity</button>`
+})
+export class OrderQuantityComponent {
+  #openNumberInputDialog = injectNumberInputDialog();
+
+  async selectQuantity() {
+    const result = await this.#openNumberInputDialog({
+      title: 'Order Quantity',
+      data: {
+        message: 'Select the number of items to order:',
+        subMessage: 'Available:',
+        subMessageValue: '50 units',
+        inputLabel: 'Quantity',
+        inputValue: 1,
+        inputDefaultValue: 1,
+        inputValidation: [
+          {
+            errorKey: 'required',
+            inputValidator: Validators.required,
+            errorText: 'Quantity is required'
+          },
+          {
+            errorKey: 'min',
+            inputValidator: Validators.min(1),
+            errorText: 'Minimum quantity is 1'
+          },
+          {
+            errorKey: 'max',
+            inputValidator: Validators.max(50),
+            errorText: 'Maximum quantity is 50'
+          }
+        ],
+        confirmText: 'Add to Cart',
+        closeText: 'Cancel'
+      }
+    }).closed.toPromise();
+
+    if (result?.inputValue) {
+      console.log('Quantity selected:', result.inputValue);
+      // Add to cart
+    }
+  }
+}
+```
+
+### Feedback Dialog with Auto-Close
+
+```typescript
+import { Component } from '@angular/core';
+import { injectFeedbackDialog } from '@isa/ui/dialog';
+
+@Component({
+  selector: 'app-save-button',
+  template: `<button (click)="saveData()">Save</button>`
+})
+export class SaveButtonComponent {
+  #openFeedbackDialog = injectFeedbackDialog();
+
+  async saveData() {
+    try {
+      // Simulate save operation
+      await this.performSave();
+
+      // Show success feedback
+      this.#openFeedbackDialog({
+        data: {
+          message: 'Data saved successfully!',
+          autoClose: true,
+          autoCloseDelay: 2000
+        }
+      });
+    } catch (error) {
+      console.error('Save failed:', error);
+    }
+  }
+
+  private async performSave(): Promise<void> {
+    // Simulate async save
+    return new Promise(resolve => setTimeout(resolve, 1000));
+  }
+}
+```
+
+### Custom Dialog Component
+
+```typescript
+// custom-dialog.component.ts
+import { Component } from '@angular/core';
+import { DialogContentDirective } from '@isa/ui/dialog';
+import { ButtonComponent } from '@isa/ui/buttons';
+
+interface CustomDialogData {
+  title: string;
+  items: string[];
+}
+
+interface CustomDialogResult {
+  selectedItem: string;
+}
+
+@Component({
+  selector: 'app-custom-dialog',
+  template: `
+    <h2>{{ data.title }}</h2>
+    <ul>
+      @for (item of data.items; track item) {
+        <li>
+          <button uiButton (click)="selectItem(item)">
+            {{ item }}
+          </button>
+        </li>
+      }
+    </ul>
+    <button uiButton (click)="close()">Cancel</button>
+  `,
+  imports: [ButtonComponent]
+})
+export class CustomDialogComponent extends DialogContentDirective<
+  CustomDialogData,
+  CustomDialogResult
+> {
+  selectItem(item: string) {
+    this.close({ selectedItem: item });
+  }
+}
+
+// Using the custom dialog
+import { injectDialog } from '@isa/ui/dialog';
+import { CustomDialogComponent } from './custom-dialog.component';
+
+@Component({
+  selector: 'app-selector',
+  template: `<button (click)="openSelector()">Select Item</button>`
+})
+export class SelectorComponent {
+  #openCustomDialog = injectDialog(CustomDialogComponent, {
+    title: 'Select an Item'
+  });
+
+  async openSelector() {
+    const result = await this.#openCustomDialog({
+      data: {
+        title: 'Choose Your Option',
+        items: ['Option A', 'Option B', 'Option C']
+      }
+    }).closed.toPromise();
+
+    if (result) {
+      console.log('Selected:', result.selectedItem);
+    }
+  }
+}
+```
+
+## Dialog Presets
+
+### MessageDialog
+**Purpose:** Display simple informational messages
+**Use Case:** Alerts, notifications, information display
+**Returns:** void
+
+### ConfirmationDialog
+**Purpose:** Get user confirmation for actions
+**Use Case:** Delete confirmations, action confirmations
+**Returns:** `{ confirmed: boolean }`
+
+### TextInputDialog
+**Purpose:** Collect text input with validation
+**Use Case:** Rename, create new item, enter search query
+**Returns:** `{ inputValue?: string }`
+**Features:** Full reactive forms validation support
+
+### NumberInputDialog
+**Purpose:** Collect numeric input with validation
+**Use Case:** Quantity selection, price entry, numeric configuration
+**Returns:** `{ inputValue?: number }`
+**Features:** Validation, default values, min/max constraints
+
+### FeedbackDialog
+**Purpose:** Show success feedback
+**Use Case:** Save confirmation, operation success
+**Returns:** void
+**Features:** Auto-close after configurable delay
+
+### FeedbackErrorDialog
+**Purpose:** Show error feedback
+**Use Case:** Error messages, operation failures
+**Returns:** void
+**Features:** Error styling, persistent display
+
+## Advanced Usage
+
+### Handling Dialog Results
+
+```typescript
+// Using async/await
+async openDialogAsync() {
+  const result = await this.#openConfirmDialog({...}).closed.toPromise();
+  if (result?.confirmed) {
+    // Handle confirmation
+  }
+}
+
+// Using subscribe
+openDialogSubscribe() {
+  const dialogRef = this.#openConfirmDialog({...});
+
+  dialogRef.closed.subscribe(result => {
+    if (result?.confirmed) {
+      // Handle confirmation
+    }
+  });
+}
+
+// Using observable operators
+openDialogOperators() {
+  this.#openConfirmDialog({...}).closed
+    .pipe(
+      filter(result => result?.confirmed),
+      switchMap(() => this.performAction())
+    )
+    .subscribe();
+}
+```
+
+### Dynamic Dialog Configuration
+
+```typescript
+@Component({...})
+export class DynamicDialogComponent {
+  #openConfirmDialog = injectConfirmationDialog();
+
+  confirmWithDynamicConfig(isDangerous: boolean) {
+    this.#openConfirmDialog({
+      title: isDangerous ? 'Warning!' : 'Confirm',
+      classList: isDangerous ? ['dialog-danger'] : [],
+      width: isDangerous ? '600px' : '400px',
+      data: {
+        message: isDangerous
+          ? 'This action is irreversible!'
+          : 'Do you want to proceed?',
+        confirmText: isDangerous ? 'I Understand' : 'OK'
+      }
+    });
+  }
+}
+```
+
+### Preventing Backdrop Close
+
+```typescript
+// Dialog cannot be closed by clicking backdrop
+#openDialog = injectDialog(MyDialogComponent, {
+  disableClose: true,
+  hasBackdrop: true
+});
+
+// Dialog can be closed by clicking backdrop
+#openDialog = injectDialog(MyDialogComponent, {
+  disableClose: false,
+  hasBackdrop: true
+});
+```
+
+## Testing
+
+The library uses **Jest** with **Spectator** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test ui-dialog --skip-nx-cache
+
+# Run tests with coverage
+npx nx test ui-dialog --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test ui-dialog --watch
+```
+
+### Test Coverage
+
+The library includes comprehensive unit tests covering:
+
+- **Dialog opening and closing** - Lifecycle management
+- **Data passing** - Input data and result handling
+- **Validation** - Form validation in input dialogs
+- **Auto-close** - Feedback dialog auto-dismiss
+- **Configuration** - All dialog options and variants
+- **Type safety** - TypeScript type inference
+
+### Example Test
+
+```typescript
+import { createComponentFactory, Spectator } from '@ngneat/spectator/jest';
+import { DialogContentDirective } from './dialog-content.directive';
+
+describe('DialogContentDirective', () => {
+  let spectator: Spectator<DialogContentDirective<any, any>>;
+  const createComponent = createComponentFactory(DialogContentDirective);
+
+  beforeEach(() => {
+    spectator = createComponent();
+  });
+
+  it('should create', () => {
+    expect(spectator.component).toBeTruthy();
+  });
+
+  it('should close with result', () => {
+    const result = { value: 'test' };
+    spectator.component.close(result);
+    // Assert dialog closed with result
+  });
+});
+```
+
+## Architecture Notes
+
+### Design Patterns
+
+#### 1. Injection-Based API
+Uses Angular's dependency injection for dialog configuration:
+
+```typescript
+// Inject dialog factory in constructor/field
+#openDialog = injectDialog(MyComponent, defaultOptions);
+
+// Call factory to open dialog
+this.#openDialog({ data: {...}, ...overrideOptions });
+```
+
+**Benefits:**
+- Type-safe configuration
+- Compile-time checking
+- Clear API surface
+- Easy testing
+
+#### 2. Two-Tier Configuration
+Supports both default options (inject-time) and override options (open-time):
+
+```typescript
+// Default options at injection
+#openDialog = injectDialog(Component, {
+  width: '400px',
+  title: 'Default Title'
+});
+
+// Override at open-time
+this.#openDialog({
+  title: 'Custom Title',  // Overrides default
+  // width: '400px' inherited from default
+  data: {...}
+});
+```
+
+#### 3. Base Component Extension
+All preset dialogs extend `DialogContentDirective`:
+
+```typescript
+export class MessageDialogComponent extends DialogContentDirective<
+  MessageDialogData,
+  void
+> {}
+```
+
+**Benefits:**
+- Automatic data/dialogRef injection
+- Consistent API
+- Type inference
+- Reusable close() method
+
+### Known Architectural Considerations
+
+#### 1. Close Button Display (Important)
+
+**Current State:**
+- `displayClose` defaults to `false` (#5275)
+- Changing default to `true` would require reviewing all existing dialogs
+- Some dialogs may have logic that depends on `undefined` being returned when X is clicked
+
+**Consideration:**
+- Explicit opt-in prevents breaking changes
+- Future: Consider migrating to `true` default with migration guide
+
+**Impact:** Medium - Affects dialog UX consistency
+
+#### 2. DialogRef Observable Pattern
+
+**Current State:**
+- `DialogRef.closed` is an Observable
+- Requires `.toPromise()` for async/await usage
+- Multiple subscription patterns supported
+
+**Consideration:**
+- Could provide both Promise and Observable APIs
+- Observable is more flexible but requires RxJS knowledge
+
+**Impact:** Low - Current pattern is Angular-idiomatic
+
+### Performance Considerations
+
+1. **OnPush Change Detection** - All dialog components use OnPush
+2. **Lazy Loading** - Dialog content only instantiated when opened
+3. **CDK Overlay** - Efficient positioning and backdrop management
+4. **Auto-Close Cleanup** - Feedback dialogs properly clean up timers
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework
+- `@angular/cdk/dialog` - Dialog primitives
+- `@angular/cdk/portal` - Component portal system
+- `@angular/forms` - Reactive forms (for input dialogs)
+- `@isa/ui/buttons` - Button components
+- `@isa/ui/input-controls` - Input components (for input dialogs)
+- `@ng-icons/core` - Icon system
+- `@isa/icons` - ISA icon library
+- `rxjs` - Reactive programming
+
+### Path Alias
+
+Import from: `@isa/ui/dialog`
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/ui/empty-state/README.md b/libs/ui/empty-state/README.md
index 90cab2c16..6be540cd8 100644
--- a/libs/ui/empty-state/README.md
+++ b/libs/ui/empty-state/README.md
@@ -1,7 +1,829 @@
-# ui-empty-state
+# @isa/ui/empty-state
 
-This library was generated with [Nx](https://nx.dev).
+A standalone Angular component library providing consistent empty state displays for various scenarios (no results, no articles, all done, select action). Part of the ISA Design System.
 
-## Running unit tests
+## Overview
 
-Run `nx test ui-empty-state` to execute the unit tests.
+The Empty State component library delivers a reusable, accessible empty state component with multiple appearance variants and customizable content. It provides visual feedback to users when data is unavailable, actions are complete, or user input is required.
+
+### Key Features
+
+- **Multiple Appearance Variants**: 4 pre-configured visual styles (NoResults, NoArticles, AllDone, SelectAction)
+- **Embedded SVG Icons**: Rich, contextual SVG illustrations with dynamic rendering
+- **Content Projection**: Flexible action area for custom buttons/links via `<ng-content>`
+- **Signal-Based Architecture**: Modern Angular signals for reactive icon rendering
+- **Sanitized HTML**: Secure SVG rendering using Angular's DomSanitizer
+- **OnPush Change Detection**: Optimized performance with minimal re-renders
+- **Type-Safe API**: Strongly typed appearance options with TypeScript const assertions
+- **SCSS Styling**: Component-scoped styles with CSS class hooks
+
+## Installation
+
+This library is part of the ISA monorepo and uses path aliases for imports:
+
+```typescript
+import { EmptyStateComponent, EmptyStateAppearance } from '@isa/ui/empty-state';
+```
+
+## Quick Start
+
+### Basic Usage
+
+```typescript
+import { Component } from '@angular/core';
+import { EmptyStateComponent, EmptyStateAppearance } from '@isa/ui/empty-state';
+
+@Component({
+  selector: 'app-search-results',
+  standalone: true,
+  imports: [EmptyStateComponent],
+  template: `
+    <ui-empty-state
+      title="Keine Ergebnisse gefunden"
+      description="Versuchen Sie es mit anderen Suchbegriffen oder Filtern."
+      [appearance]="EmptyStateAppearance.NoResults"
+    />
+  `
+})
+export class SearchResultsComponent {
+  EmptyStateAppearance = EmptyStateAppearance;
+}
+```
+
+### With Custom Actions
+
+```typescript
+import { Component } from '@angular/core';
+import { EmptyStateComponent, EmptyStateAppearance } from '@isa/ui/empty-state';
+import { ButtonComponent } from '@isa/ui/buttons';
+
+@Component({
+  selector: 'app-product-list',
+  standalone: true,
+  imports: [EmptyStateComponent, ButtonComponent],
+  template: `
+    <ui-empty-state
+      title="Keine Artikel verfügbar"
+      description="Es wurden keine passenden Artikel gefunden."
+      [appearance]="EmptyStateAppearance.NoArticles"
+    >
+      <ui-button (click)="resetFilters()">Filter zurücksetzen</ui-button>
+      <ui-button variant="secondary" (click)="goBack()">Zurück</ui-button>
+    </ui-empty-state>
+  `
+})
+export class ProductListComponent {
+  EmptyStateAppearance = EmptyStateAppearance;
+
+  resetFilters(): void {
+    // Reset filter logic
+  }
+
+  goBack(): void {
+    // Navigation logic
+  }
+}
+```
+
+## API Reference
+
+### EmptyStateComponent
+
+**Selector**: `ui-empty-state`
+
+#### Inputs
+
+| Input | Type | Default | Required | Description |
+|-------|------|---------|----------|-------------|
+| `title` | `string` | - | ✅ | Main heading text for the empty state |
+| `description` | `string` | - | ✅ | Supporting description text |
+| `appearance` | `EmptyStateAppearance` | `EmptyStateAppearance.NoResults` | ❌ | Visual variant (determines icon) |
+
+#### Content Projection
+
+- **Default Slot**: Projects custom action buttons/links into the `.ui-empty-state-actions` container
+
+#### Host Properties
+
+- **CSS Class**: `.ui-empty-state` - Applied to the host element for styling
+
+#### Component Configuration
+
+- **Change Detection**: `OnPush` - Optimized for performance
+- **View Encapsulation**: `None` - Allows global styles to cascade
+- **Standalone**: `true` - Can be imported directly without NgModule
+
+### EmptyStateAppearance Type
+
+```typescript
+export const EmptyStateAppearance = {
+  NoResults: 'noResults',      // Search/filter returned no results
+  NoArticles: 'noArticles',    // No articles/products available
+  AllDone: 'allDone',          // Task completion state
+  SelectAction: 'selectAction' // User needs to select an action
+} as const;
+
+export type EmptyStateAppearance =
+  (typeof EmptyStateAppearance)[keyof typeof EmptyStateAppearance];
+```
+
+#### Appearance Variants
+
+| Variant | Icon | Use Case |
+|---------|------|----------|
+| `NoResults` | Document with magnifying glass and X | Search returned no matches, filters excluded all items |
+| `NoArticles` | Document with X mark | Product catalog is empty, no items in category |
+| `AllDone` | Coffee cup with steam | All tasks completed, inbox zero state |
+| `SelectAction` | Hand pointer with dropdown | User needs to choose from dropdown/menu |
+
+## Usage Examples
+
+### Example 1: Search Results Empty State
+
+```typescript
+import { Component, computed, signal } from '@angular/core';
+import { EmptyStateComponent, EmptyStateAppearance } from '@isa/ui/empty-state';
+import { ButtonComponent } from '@isa/ui/buttons';
+
+@Component({
+  selector: 'app-customer-search',
+  standalone: true,
+  imports: [EmptyStateComponent, ButtonComponent],
+  template: `
+    @if (hasResults()) {
+      <!-- Display results -->
+    } @else {
+      <ui-empty-state
+        title="Keine Kunden gefunden"
+        description="Ihre Suche ergab keine Treffer. Überprüfen Sie Ihre Suchkriterien oder versuchen Sie es mit anderen Begriffen."
+        [appearance]="EmptyStateAppearance.NoResults"
+      >
+        <ui-button (click)="clearSearch()">Suche zurücksetzen</ui-button>
+      </ui-empty-state>
+    }
+  `
+})
+export class CustomerSearchComponent {
+  EmptyStateAppearance = EmptyStateAppearance;
+
+  searchResults = signal<Customer[]>([]);
+  hasResults = computed(() => this.searchResults().length > 0);
+
+  clearSearch(): void {
+    this.searchResults.set([]);
+  }
+}
+```
+
+### Example 2: Task Completion State
+
+```typescript
+import { Component } from '@angular/core';
+import { EmptyStateComponent, EmptyStateAppearance } from '@isa/ui/empty-state';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-return-process',
+  standalone: true,
+  imports: [EmptyStateComponent],
+  template: `
+    <ui-empty-state
+      title="Alle Rücksendungen bearbeitet"
+      description="Großartig! Sie haben alle ausstehenden Rücksendungen abgeschlossen."
+      [appearance]="EmptyStateAppearance.AllDone"
+    >
+      <ui-button (click)="goToDashboard()">Zum Dashboard</ui-button>
+    </ui-empty-state>
+  `
+})
+export class ReturnProcessComponent {
+  EmptyStateAppearance = EmptyStateAppearance;
+
+  constructor(private router: Router) {}
+
+  goToDashboard(): void {
+    this.router.navigate(['/dashboard']);
+  }
+}
+```
+
+### Example 3: Action Selection Required
+
+```typescript
+import { Component } from '@angular/core';
+import { EmptyStateComponent, EmptyStateAppearance } from '@isa/ui/empty-state';
+
+@Component({
+  selector: 'app-workflow-start',
+  standalone: true,
+  imports: [EmptyStateComponent],
+  template: `
+    <ui-empty-state
+      title="Wählen Sie eine Aktion aus"
+      description="Bitte wählen Sie aus dem Dropdown-Menü oben eine Aktion aus, um fortzufahren."
+      [appearance]="EmptyStateAppearance.SelectAction"
+    />
+  `
+})
+export class WorkflowStartComponent {
+  EmptyStateAppearance = EmptyStateAppearance;
+}
+```
+
+### Example 4: Conditional Appearance Based on Context
+
+```typescript
+import { Component, computed, signal } from '@angular/core';
+import { EmptyStateComponent, EmptyStateAppearance } from '@isa/ui/empty-state';
+
+type EmptyReason = 'no-results' | 'no-articles' | 'completed' | 'select-action';
+
+@Component({
+  selector: 'app-dynamic-empty-state',
+  standalone: true,
+  imports: [EmptyStateComponent],
+  template: `
+    <ui-empty-state
+      [title]="emptyTitle()"
+      [description]="emptyDescription()"
+      [appearance]="emptyAppearance()"
+    >
+      @if (reason() === 'no-results') {
+        <ui-button (click)="resetFilters()">Filter zurücksetzen</ui-button>
+      }
+    </ui-empty-state>
+  `
+})
+export class DynamicEmptyStateComponent {
+  reason = signal<EmptyReason>('no-results');
+
+  emptyAppearance = computed(() => {
+    switch (this.reason()) {
+      case 'no-results':
+        return EmptyStateAppearance.NoResults;
+      case 'no-articles':
+        return EmptyStateAppearance.NoArticles;
+      case 'completed':
+        return EmptyStateAppearance.AllDone;
+      case 'select-action':
+        return EmptyStateAppearance.SelectAction;
+      default:
+        return EmptyStateAppearance.NoResults;
+    }
+  });
+
+  emptyTitle = computed(() => {
+    switch (this.reason()) {
+      case 'no-results':
+        return 'Keine Ergebnisse';
+      case 'no-articles':
+        return 'Keine Artikel';
+      case 'completed':
+        return 'Alles erledigt';
+      case 'select-action':
+        return 'Aktion auswählen';
+      default:
+        return 'Leer';
+    }
+  });
+
+  emptyDescription = computed(() => {
+    // Description logic based on reason
+    return 'Beschreibung basierend auf dem Kontext';
+  });
+
+  resetFilters(): void {
+    // Reset logic
+  }
+}
+```
+
+## Architecture Notes
+
+### Component Structure
+
+```
+EmptyStateComponent
+├── Host Element (.ui-empty-state)
+│   ├── Sub-Icon Container (@if sanitizedSubIcon())
+│   │   └── [innerHTML] (AllDone steam, SelectAction hand)
+│   ├── Main Icon Circle (.ui-empty-state-circle)
+│   │   └── [innerHTML] (Primary SVG icon)
+│   ├── Title (.ui-empty-state-title)
+│   │   └── {{ title() }}
+│   ├── Description (.ui-empty-state-description)
+│   │   └── {{ description() }}
+│   └── Actions Container (.ui-empty-state-actions)
+│       └── <ng-content> (Projected buttons/links)
+```
+
+### Signal Computation Flow
+
+```typescript
+// 1. Input signals (set by parent component)
+appearance: InputSignal<EmptyStateAppearance>
+
+// 2. Derived computed signals
+icon: Signal<string> = computed(() => {
+  // Maps appearance to primary SVG constant
+})
+
+subIcon: Signal<string> = computed(() => {
+  // Returns secondary SVG for AllDone/SelectAction, empty string otherwise
+})
+
+// 3. Sanitized computed signals
+sanitizedIcon: Signal<SafeHtml> = computed(() => {
+  // Bypasses security for safe HTML rendering
+})
+
+sanitizedSubIcon: Signal<SafeHtml | undefined> = computed(() => {
+  // Conditionally sanitizes sub-icon if present
+})
+```
+
+### SVG Icon Management
+
+**Constants Module** (`constants.ts`):
+- Stores complete SVG markup as string constants
+- Each SVG includes viewBox, dimensions, and semantic path data
+- Icons designed for ISA color palette (`#CED4DA`, `#6C757D`)
+
+**Icon Selection Logic**:
+```typescript
+icon = computed(() => {
+  const appearance = this.appearance();
+  switch (appearance) {
+    case EmptyStateAppearance.NoArticles:
+      return NO_ARTICLES;
+    case EmptyStateAppearance.AllDone:
+      return ALL_DONE_CUP;
+    case EmptyStateAppearance.SelectAction:
+      return SELECT_ACTION_OBJECT_DROPDOWN;
+    case EmptyStateAppearance.NoResults:
+    default:
+      return NO_RESULTS;
+  }
+});
+```
+
+### Security Considerations
+
+**DomSanitizer Usage**:
+- All SVG content sanitized via `bypassSecurityTrustHtml()`
+- Safe because SVG constants are internal, trusted sources
+- Prevents XSS attacks from user-supplied content
+- Template binding via `[innerHTML]` for dynamic rendering
+
+**Why Sanitization is Safe Here**:
+1. SVG strings are hardcoded constants (not user input)
+2. No dynamic interpolation of external data into SVGs
+3. Icons are static, design-system-approved assets
+4. DomSanitizer explicitly bypasses only for known-safe content
+
+### Styling Architecture
+
+**Component SCSS** (`empty-state.component.scss`):
+- Scoped to `.ui-empty-state` class
+- Defines layout, spacing, and typography
+- Uses ISA design tokens for consistency
+- CSS classes target: `.ui-empty-state-circle`, `.ui-empty-state-title`, `.ui-empty-state-description`, `.ui-empty-state-actions`
+
+**Global Style Integration**:
+- `ViewEncapsulation.None` allows external styles to cascade
+- Tailwind utilities can style projected content
+- Maintains design system consistency
+
+### Performance Characteristics
+
+**Optimization Strategies**:
+- **OnPush Change Detection**: Component only re-renders when inputs change
+- **Computed Signals**: Icon selection memoized, recalculates only on appearance change
+- **Conditional Rendering**: Sub-icons only render when present (`@if sanitizedSubIcon()`)
+- **Static Constants**: SVG strings stored in memory once, reused across instances
+
+**Bundle Impact**:
+- Standalone component with minimal dependencies
+- SVG icons increase bundle size (~4KB total for all icons)
+- No external image assets required
+- Tree-shakeable via ES modules
+
+## Dependencies
+
+### Angular Dependencies
+
+| Package | Version | Purpose |
+|---------|---------|---------|
+| `@angular/core` | 20.1.2 | Component framework, signals, dependency injection |
+| `@angular/platform-browser` | 20.1.2 | DomSanitizer for secure HTML rendering |
+
+### Internal Dependencies
+
+None - this library is fully self-contained with no dependencies on other `@isa/*` libraries.
+
+### Peer Dependencies
+
+This library expects the following packages in the consuming application:
+
+```json
+{
+  "peerDependencies": {
+    "@angular/core": "^20.0.0",
+    "@angular/platform-browser": "^20.0.0"
+  }
+}
+```
+
+## Testing
+
+### Test Configuration
+
+**Framework**: Jest (legacy, migrating to Vitest)
+
+**Test File**: `empty-state.component.spec.ts`
+
+**Configuration**: `jest.config.ts` (extends workspace defaults)
+
+### Running Tests
+
+```bash
+# Run tests with fresh results (skip Nx cache)
+npx nx test ui-empty-state --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test ui-empty-state --watch
+
+# Run tests with coverage
+npx nx test ui-empty-state --code-coverage --skip-nx-cache
+```
+
+### Testing Recommendations
+
+#### Unit Test Coverage
+
+**Test appearance variants**:
+```typescript
+it('should display NoResults icon by default', () => {
+  const fixture = TestBed.createComponent(EmptyStateComponent);
+  fixture.componentRef.setInput('title', 'No Results');
+  fixture.componentRef.setInput('description', 'Try again');
+  fixture.detectChanges();
+
+  const compiled = fixture.nativeElement;
+  const iconElement = compiled.querySelector('.ui-empty-state-circle');
+  expect(iconElement.innerHTML).toContain('M75.5 43.794V30.1846');
+});
+```
+
+**Test content projection**:
+```typescript
+it('should project custom actions into actions container', () => {
+  const fixture = TestBed.createComponent(EmptyStateComponent);
+  fixture.componentRef.setInput('title', 'Test');
+  fixture.componentRef.setInput('description', 'Test');
+
+  const compiled = fixture.nativeElement;
+  const actionsContainer = compiled.querySelector('.ui-empty-state-actions');
+  const projectedButton = actionsContainer.querySelector('button');
+
+  expect(projectedButton).toBeTruthy();
+  expect(projectedButton.textContent).toContain('Custom Action');
+});
+```
+
+**Test sanitization**:
+```typescript
+it('should sanitize icon HTML for security', () => {
+  const component = new EmptyStateComponent();
+  const sanitizer = TestBed.inject(DomSanitizer);
+
+  // Verify sanitizer is injected
+  expect(component['#sanitizer']).toBeDefined();
+
+  // Verify sanitized output
+  const sanitizedIcon = component.sanitizedIcon();
+  expect(sanitizedIcon).toBeTruthy();
+});
+```
+
+#### Integration Test Scenarios
+
+**Test with routing actions**:
+```typescript
+@Component({
+  template: `
+    <ui-empty-state
+      title="Test"
+      description="Test description"
+      [appearance]="EmptyStateAppearance.NoResults"
+    >
+      <button (click)="navigate()">Go Home</button>
+    </ui-empty-state>
+  `
+})
+class TestHostComponent {
+  EmptyStateAppearance = EmptyStateAppearance;
+  navigated = false;
+
+  navigate(): void {
+    this.navigated = true;
+  }
+}
+
+it('should trigger navigation when action button clicked', () => {
+  const fixture = TestBed.createComponent(TestHostComponent);
+  fixture.detectChanges();
+
+  const button = fixture.nativeElement.querySelector('button');
+  button.click();
+
+  expect(fixture.componentInstance.navigated).toBe(true);
+});
+```
+
+## Best Practices
+
+### 1. Choose Appropriate Appearance
+
+Match the appearance variant to the user's context:
+
+```typescript
+// ✅ GOOD: Context-appropriate variant
+<ui-empty-state
+  title="Keine Suchergebnisse"
+  description="..."
+  [appearance]="EmptyStateAppearance.NoResults"
+/>
+
+// ❌ BAD: Misleading variant
+<ui-empty-state
+  title="Keine Suchergebnisse"
+  description="..."
+  [appearance]="EmptyStateAppearance.AllDone"  // Wrong icon!
+/>
+```
+
+### 2. Provide Actionable Guidance
+
+Always include helpful descriptions and recovery actions:
+
+```typescript
+// ✅ GOOD: Clear guidance with actions
+<ui-empty-state
+  title="Keine Artikel gefunden"
+  description="Versuchen Sie, Ihre Suchkriterien anzupassen oder Filter zurückzusetzen."
+>
+  <ui-button (click)="resetFilters()">Filter zurücksetzen</ui-button>
+  <ui-button variant="secondary" (click)="clearSearch()">Suche löschen</ui-button>
+</ui-empty-state>
+
+// ❌ BAD: Vague, no actions
+<ui-empty-state
+  title="Nichts gefunden"
+  description="Keine Daten"
+/>
+```
+
+### 3. Use Computed Signals for Dynamic Content
+
+Leverage Angular signals for reactive empty states:
+
+```typescript
+// ✅ GOOD: Reactive, computed approach
+export class ProductListComponent {
+  products = signal<Product[]>([]);
+  isLoading = signal(false);
+
+  emptyTitle = computed(() => {
+    if (this.isLoading()) return 'Laden...';
+    return 'Keine Produkte gefunden';
+  });
+
+  emptyDescription = computed(() => {
+    if (this.isLoading()) return 'Bitte warten...';
+    return 'Versuchen Sie es mit anderen Filtern.';
+  });
+}
+
+// ❌ BAD: Static, non-reactive
+export class ProductListComponent {
+  emptyTitle = 'Keine Produkte';  // Won't update dynamically
+}
+```
+
+### 4. Maintain Consistent Messaging
+
+Follow ISA language guidelines for title/description text:
+
+```typescript
+// ✅ GOOD: Professional, helpful tone
+title="Keine Rücksendungen vorhanden"
+description="Es liegen derzeit keine Rücksendungen vor. Neue Rücksendungen erscheinen automatisch hier."
+
+// ❌ BAD: Casual, unhelpful
+title="Ups, nichts da!"
+description="Schade."
+```
+
+### 5. Test All Appearance Variants
+
+Ensure all visual variants render correctly:
+
+```typescript
+describe('EmptyStateComponent Appearances', () => {
+  const appearances = [
+    EmptyStateAppearance.NoResults,
+    EmptyStateAppearance.NoArticles,
+    EmptyStateAppearance.AllDone,
+    EmptyStateAppearance.SelectAction
+  ];
+
+  appearances.forEach(appearance => {
+    it(`should render ${appearance} appearance correctly`, () => {
+      const fixture = TestBed.createComponent(EmptyStateComponent);
+      fixture.componentRef.setInput('title', 'Test');
+      fixture.componentRef.setInput('description', 'Test');
+      fixture.componentRef.setInput('appearance', appearance);
+      fixture.detectChanges();
+
+      const iconElement = fixture.nativeElement.querySelector('.ui-empty-state-circle');
+      expect(iconElement).toBeTruthy();
+      expect(iconElement.innerHTML).toContain('svg');
+    });
+  });
+});
+```
+
+### 6. Accessibility Considerations
+
+Ensure empty states are accessible:
+
+```typescript
+// ✅ GOOD: Semantic HTML with ARIA
+<ui-empty-state
+  title="Keine Ergebnisse"
+  description="Ihre Suche ergab keine Treffer"
+  role="status"
+  aria-live="polite"
+>
+  <ui-button>Filter zurücksetzen</ui-button>
+</ui-empty-state>
+
+// Consider adding to template:
+// <div role="status" aria-live="polite">
+//   <ui-empty-state .../>
+// </div>
+```
+
+### 7. Avoid Overuse
+
+Don't use empty states for loading or error conditions:
+
+```typescript
+// ✅ GOOD: Empty state for actual empty data
+@if (products().length === 0 && !isLoading()) {
+  <ui-empty-state .../>
+}
+
+// ❌ BAD: Empty state for loading
+@if (isLoading()) {
+  <ui-empty-state title="Laden..." description="Bitte warten"/>
+}
+// Use a loading spinner instead!
+```
+
+## Common Pitfalls
+
+### 1. Forgetting Required Inputs
+
+```typescript
+// ❌ ERROR: Missing required inputs
+<ui-empty-state [appearance]="EmptyStateAppearance.NoResults" />
+// Angular will throw an error for missing title/description
+
+// ✅ CORRECT: All required inputs provided
+<ui-empty-state
+  title="Erforderlich"
+  description="Erforderlich"
+  [appearance]="EmptyStateAppearance.NoResults"
+/>
+```
+
+### 2. Incorrect Appearance Type
+
+```typescript
+// ❌ ERROR: Invalid string literal
+<ui-empty-state
+  title="Test"
+  description="Test"
+  appearance="no-results"  // TypeScript error!
+/>
+
+// ✅ CORRECT: Use EmptyStateAppearance enum
+<ui-empty-state
+  title="Test"
+  description="Test"
+  [appearance]="EmptyStateAppearance.NoResults"
+/>
+```
+
+### 3. Projecting Non-Action Content
+
+```typescript
+// ❌ BAD: Projecting large content blocks
+<ui-empty-state title="Test" description="Test">
+  <div>
+    <p>Long paragraph...</p>
+    <table>...</table>
+  </div>
+</ui-empty-state>
+
+// ✅ GOOD: Project only action buttons
+<ui-empty-state title="Test" description="Test">
+  <ui-button>Action 1</ui-button>
+  <ui-button variant="secondary">Action 2</ui-button>
+</ui-empty-state>
+```
+
+## Migration Guide
+
+### From Custom Empty States to @isa/ui/empty-state
+
+**Before**:
+```typescript
+@Component({
+  template: `
+    <div class="empty-state">
+      <img src="/assets/no-results.svg" alt="No Results">
+      <h2>Keine Ergebnisse</h2>
+      <p>Versuchen Sie es erneut.</p>
+      <button (click)="retry()">Erneut versuchen</button>
+    </div>
+  `
+})
+```
+
+**After**:
+```typescript
+import { EmptyStateComponent, EmptyStateAppearance } from '@isa/ui/empty-state';
+
+@Component({
+  standalone: true,
+  imports: [EmptyStateComponent],
+  template: `
+    <ui-empty-state
+      title="Keine Ergebnisse"
+      description="Versuchen Sie es erneut."
+      [appearance]="EmptyStateAppearance.NoResults"
+    >
+      <ui-button (click)="retry()">Erneut versuchen</ui-button>
+    </ui-empty-state>
+  `
+})
+```
+
+**Benefits**:
+- Consistent design across application
+- Built-in icons, no asset management
+- Accessible, semantic HTML structure
+- Optimized rendering performance
+
+## Related Documentation
+
+- **ISA Design System**: Design guidelines for empty states
+- **@isa/ui/buttons**: Button components for empty state actions
+- **Angular Signals Guide**: Understanding reactive signal patterns
+- **Security Best Practices**: DomSanitizer usage guidelines
+
+## Support and Contributing
+
+For questions, issues, or contributions related to the Empty State component:
+
+1. Check existing tests in `empty-state.component.spec.ts` for usage examples
+2. Review SCSS styles for customization guidance
+3. Consult ISA Design System for visual/UX standards
+4. Follow Angular standalone component best practices
+
+## Changelog
+
+### Current Version
+
+**Features**:
+- Standalone component architecture
+- 4 appearance variants with embedded SVG icons
+- Signal-based reactive rendering
+- Content projection for custom actions
+- OnPush change detection optimization
+- Secure HTML sanitization
+
+**Testing**:
+- Jest configuration (migrating to Vitest)
+- Component unit tests with Spectator (migrating to Angular Testing Library)
+
+---
+
+**Package**: `@isa/ui/empty-state`
+**Path Alias**: `@isa/ui/empty-state`
+**Entry Point**: `libs/ui/empty-state/src/index.ts`
+**Selector**: `ui-empty-state`
+**Type**: Standalone Angular Component Library
diff --git a/libs/ui/input-controls/README.md b/libs/ui/input-controls/README.md
index bfca4f50e..14bb076d3 100644
--- a/libs/ui/input-controls/README.md
+++ b/libs/ui/input-controls/README.md
@@ -1,7 +1,609 @@
-# ui-input-controls
+# @isa/ui/input-controls
 
-This library was generated with [Nx](https://nx.dev).
+A comprehensive collection of form input components and directives for Angular applications supporting reactive forms, template-driven forms, and accessibility features.
 
-## Running unit tests
+## Overview
 
-Run `nx test ui-input-controls` to execute the unit tests.
+The Input Controls library provides a complete suite of reusable form components built on Angular's reactive forms API and Angular CDK. It includes text fields, checkboxes, dropdowns, chips, checklists, listboxes, and inline inputs - all designed to work seamlessly with Angular Forms while maintaining consistent styling and behavior across the ISA application.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Form Integration](#form-integration)
+- [Accessibility](#accessibility)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Complete form control suite** - 8 component types covering common input scenarios
+- **Reactive Forms integration** - ControlValueAccessor implementation for all form controls
+- **Template-driven forms** - Full ngModel support for two-way binding
+- **Keyboard navigation** - Arrow keys, Enter, Escape, and Tab support
+- **Accessibility (a11y)** - ARIA attributes, screen reader support, keyboard navigation
+- **Customizable appearance** - Multiple size and appearance variants for each control
+- **Validation support** - Integration with Angular's built-in validators
+- **CDK integration** - Built on Angular CDK primitives (listbox, a11y, overlay)
+- **Signal-based inputs** - Modern Angular signals for reactive property management
+- **Type-safe** - Full TypeScript support with generic type parameters
+
+## Quick Start
+
+### 1. Import Components
+
+```typescript
+import { Component } from '@angular/core';
+import {
+  CheckboxComponent,
+  DropdownButtonComponent,
+  DropdownOptionComponent,
+  TextFieldComponent,
+  InputControlDirective,
+} from '@isa/ui/input-controls';
+import { ReactiveFormsModule } from '@angular/forms';
+
+@Component({
+  selector: 'app-my-form',
+  imports: [
+    ReactiveFormsModule,
+    CheckboxComponent,
+    DropdownButtonComponent,
+    DropdownOptionComponent,
+    TextFieldComponent,
+    InputControlDirective,
+  ],
+  template: '...'
+})
+export class MyFormComponent {}
+```
+
+### 2. Basic Text Field
+
+```html
+<ui-text-field>
+  <input
+    type="text"
+    uiInputControl
+    formControlName="username"
+    placeholder="Enter username"
+  />
+</ui-text-field>
+```
+
+### 3. Checkbox
+
+```html
+<ui-checkbox>
+  <input type="checkbox" formControlName="acceptTerms" />
+</ui-checkbox>
+```
+
+### 4. Dropdown
+
+```html
+<ui-dropdown [(ngModel)]="selectedOption" label="Select option">
+  <ui-dropdown-option [value]="1">Option 1</ui-dropdown-option>
+  <ui-dropdown-option [value]="2">Option 2</ui-dropdown-option>
+  <ui-dropdown-option [value]="3">Option 3</ui-dropdown-option>
+</ui-dropdown>
+```
+
+## Core Concepts
+
+### Component Categories
+
+The library provides three main categories of form controls:
+
+#### 1. Text Input Controls
+- **TextFieldComponent** - Standard text input with container, labels, and errors
+- **TextareaComponent** - Multi-line text input
+- **InlineInputComponent** - Compact inline text input for space-constrained UIs
+
+#### 2. Selection Controls
+- **CheckboxComponent** - Single checkbox with bullet or checkbox appearance
+- **ChecklistComponent** - Multiple checkboxes working as a group
+- **DropdownButtonComponent** - Select dropdown with keyboard navigation
+- **ChipsComponent** - Single-select chip group
+- **ListboxDirective** - CDK listbox wrapper for custom list selections
+
+#### 3. Supporting Components
+- **InputControlDirective** - Core directive for input field integration
+- **TextFieldContainerComponent** - Layout container for text fields
+- **TextFieldErrorsComponent** - Validation error display
+- **TextFieldClearComponent** - Clear button for text inputs
+- **CheckboxLabelDirective** - Label styling for checkboxes
+- **ChecklistValueDirective** - Value binding for checklist items
+- **ChipOptionComponent** - Individual chip option
+- **DropdownOptionComponent** - Individual dropdown option
+- **ListboxItemDirective** - Individual listbox item
+
+### Control Value Accessor Pattern
+
+All form controls implement Angular's `ControlValueAccessor` interface, enabling seamless integration with both reactive and template-driven forms:
+
+```typescript
+export class DropdownButtonComponent<T> implements ControlValueAccessor {
+  value = model<T>();
+  disabled = model<boolean>(false);
+
+  writeValue(obj: unknown): void { ... }
+  registerOnChange(fn: (value: T) => void): void { ... }
+  registerOnTouched(fn: () => void): void { ... }
+  setDisabledState(isDisabled: boolean): void { ... }
+}
+```
+
+### Appearance Variants
+
+#### Checkbox Appearances
+```typescript
+const CheckboxAppearance = {
+  Bullet: 'bullet',      // Round bullet-style selector
+  Checkbox: 'checkbox',  // Traditional square checkbox (default)
+} as const;
+```
+
+#### Text Field Sizes
+```typescript
+const TextFieldSize = {
+  Small: 'small',
+  Medium: 'medium',      // Default
+  Large: 'large',
+} as const;
+```
+
+## API Reference
+
+### CheckboxComponent
+
+A customizable checkbox component supporting different visual appearances.
+
+**Selector:** `ui-checkbox`
+
+**Inputs:**
+- `appearance: CheckboxAppearance` - Visual style ('checkbox' | 'bullet'). Default: 'checkbox'
+
+**Usage:**
+```html
+<!-- Default checkbox appearance -->
+<ui-checkbox>
+  <input type="checkbox" />
+</ui-checkbox>
+
+<!-- Bullet appearance -->
+<ui-checkbox [appearance]="CheckboxAppearance.Bullet">
+  <input type="checkbox" />
+</ui-checkbox>
+```
+
+---
+
+### DropdownButtonComponent<T>
+
+A dropdown select component with keyboard navigation and CDK overlay integration.
+
+**Selector:** `ui-dropdown`
+
+**Inputs:**
+- `appearance: DropdownAppearance` - Visual style. Default: 'accent-outline'
+- `label: string` - Dropdown label text
+- `showSelectedValue: boolean` - Show selected option text. Default: true
+- `tabIndex: number` - Tab index for keyboard navigation. Default: 0
+- `id: string` - Optional element ID
+
+**Outputs:**
+- `value: ModelSignal<T>` - Two-way bindable selected value
+- `disabled: ModelSignal<boolean>` - Disabled state
+
+**Methods:**
+- `open(): void` - Opens the dropdown overlay
+- `close(): void` - Closes the dropdown overlay
+- `select(option, options?): void` - Selects an option programmatically
+
+**Keyboard Navigation:**
+- `Arrow Down/Up` - Navigate through options
+- `Enter` - Select highlighted option and close
+- `Escape` - Close dropdown
+
+**Usage:**
+```typescript
+interface Product {
+  id: number;
+  name: string;
+}
+
+products: Product[] = [
+  { id: 1, name: 'Product A' },
+  { id: 2, name: 'Product B' }
+];
+selectedProduct: Product;
+```
+
+```html
+<ui-dropdown
+  [(value)]="selectedProduct"
+  label="Select Product"
+  appearance="accent-outline">
+  @for (product of products; track product.id) {
+    <ui-dropdown-option [value]="product">
+      {{ product.name }}
+    </ui-dropdown-option>
+  }
+</ui-dropdown>
+```
+
+---
+
+### ChipsComponent<T>
+
+Single-selection chip group with form integration.
+
+**Selector:** `ui-chips`
+
+**Outputs:**
+- `value: ModelSignal<T>` - Selected chip value
+- `disabled: ModelSignal<boolean>` - Disabled state
+
+**Methods:**
+- `select(value: T, options?): void` - Selects a chip
+- `toggle(value: T, options?): void` - Toggles chip selection
+- `isSelected(value: T): boolean` - Checks if value is selected
+
+**Usage:**
+```typescript
+type Size = 'S' | 'M' | 'L' | 'XL';
+selectedSize: Size = 'M';
+```
+
+```html
+<ui-chips [(ngModel)]="selectedSize">
+  <ui-chip [value]="'S'">Small</ui-chip>
+  <ui-chip [value]="'M'">Medium</ui-chip>
+  <ui-chip [value]="'L'">Large</ui-chip>
+  <ui-chip [value]="'XL'">Extra Large</ui-chip>
+</ui-chips>
+```
+
+---
+
+### ChecklistComponent
+
+Multi-select checkbox group returning an array of selected values.
+
+**Selector:** `ui-checklist`
+
+**Outputs:**
+- `value: ModelSignal<unknown[]>` - Array of selected values
+
+**Usage:**
+```typescript
+selectedFruits: string[] = ['apple', 'banana'];
+```
+
+```html
+<ui-checklist [(ngModel)]="selectedFruits">
+  <label class="ui-checkbox-label">
+    <ui-checkbox>
+      <input type="checkbox" [uiChecklistValue]="'apple'">
+    </ui-checkbox>
+    Apple
+  </label>
+  <label class="ui-checkbox-label">
+    <ui-checkbox>
+      <input type="checkbox" [uiChecklistValue]="'banana'">
+    </ui-checkbox>
+    Banana
+  </label>
+</ui-checklist>
+```
+
+---
+
+### TextFieldComponent
+
+Container component for text input fields with consistent styling.
+
+**Selector:** `ui-text-field`
+
+**Inputs:**
+- `size: TextFieldSize` - Field size ('small' | 'medium' | 'large'). Default: 'medium'
+
+**Content Projection:**
+- Requires `InputControlDirective` on child input element
+
+**Usage:**
+```html
+<ui-text-field size="medium">
+  <input
+    type="text"
+    uiInputControl
+    formControlName="email"
+    placeholder="Enter email"
+  />
+</ui-text-field>
+```
+
+---
+
+### InlineInputComponent
+
+Compact inline text input for space-constrained interfaces.
+
+**Selector:** `ui-inline-input`
+
+**Inputs:**
+- `size: InlineInputSize` - Field size ('small' | 'medium'). Default: 'medium'
+
+**Usage:**
+```html
+<ui-inline-input size="small">
+  <input type="text" uiInputControl [(ngModel)]="quantity" />
+</ui-inline-input>
+```
+
+---
+
+### ListboxDirective
+
+Wrapper directive for Angular CDK listbox with ISA styling.
+
+**Selector:** `[uiListbox]`
+
+**Inputs (via CDK):**
+- `value: any` - Selected value(s)
+- `compareWith: (o1: any, o2: any) => boolean` - Comparison function
+- `disabled: boolean` - Disabled state
+
+**Outputs (via CDK):**
+- `valueChange: EventEmitter` - Emits when selection changes
+
+**Usage:**
+```html
+<div uiListbox [value]="selectedItem" (valueChange)="handleChange($event)">
+  <div uiListboxItem [value]="item1">Item 1</div>
+  <div uiListboxItem [value]="item2">Item 2</div>
+</div>
+```
+
+## Usage Examples
+
+### Reactive Form with Validation
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { FormBuilder, Validators, ReactiveFormsModule } from '@angular/forms';
+import {
+  TextFieldComponent,
+  TextFieldContainerComponent,
+  TextFieldErrorsComponent,
+  InputControlDirective,
+  CheckboxComponent,
+  DropdownButtonComponent,
+  DropdownOptionComponent
+} from '@isa/ui/input-controls';
+
+@Component({
+  selector: 'app-user-form',
+  imports: [
+    ReactiveFormsModule,
+    TextFieldComponent,
+    TextFieldContainerComponent,
+    TextFieldErrorsComponent,
+    InputControlDirective,
+    CheckboxComponent,
+    DropdownButtonComponent,
+    DropdownOptionComponent
+  ],
+  template: `
+    <form [formGroup]="userForm" (ngSubmit)="onSubmit()">
+      <ui-text-field-container>
+        <label>Email</label>
+        <ui-text-field>
+          <input
+            type="email"
+            uiInputControl
+            formControlName="email"
+            placeholder="user@example.com"
+          />
+        </ui-text-field>
+        <ui-text-field-errors />
+      </ui-text-field-container>
+
+      <ui-dropdown formControlName="role" label="Select Role">
+        <ui-dropdown-option [value]="'admin'">Administrator</ui-dropdown-option>
+        <ui-dropdown-option [value]="'user'">User</ui-dropdown-option>
+      </ui-dropdown>
+
+      <label class="ui-checkbox-label">
+        <ui-checkbox>
+          <input type="checkbox" formControlName="acceptTerms" />
+        </ui-checkbox>
+        I accept the terms and conditions
+      </label>
+
+      <button type="submit" [disabled]="!userForm.valid">Submit</button>
+    </form>
+  `
+})
+export class UserFormComponent {
+  #fb = inject(FormBuilder);
+
+  userForm = this.#fb.group({
+    email: ['', [Validators.required, Validators.email]],
+    role: ['user', Validators.required],
+    acceptTerms: [false, Validators.requiredTrue]
+  });
+
+  onSubmit() {
+    if (this.userForm.valid) {
+      console.log('Form submitted:', this.userForm.value);
+    }
+  }
+}
+```
+
+## Form Integration
+
+### Reactive Forms
+
+All components implement `ControlValueAccessor` and work with `FormControl`:
+
+```typescript
+import { FormControl, Validators } from '@angular/forms';
+
+emailControl = new FormControl('', [Validators.required, Validators.email]);
+roleControl = new FormControl<string>('user');
+agreeControl = new FormControl(false, Validators.requiredTrue);
+```
+
+```html
+<ui-text-field>
+  <input uiInputControl [formControl]="emailControl" />
+</ui-text-field>
+
+<ui-dropdown [formControl]="roleControl" label="Role">...</ui-dropdown>
+
+<ui-checkbox><input [formControl]="agreeControl" /></ui-checkbox>
+```
+
+### Template-Driven Forms
+
+Use `ngModel` for two-way binding:
+
+```html
+<ui-text-field>
+  <input uiInputControl [(ngModel)]="email" name="email" />
+</ui-text-field>
+
+<ui-dropdown [(ngModel)]="role" name="role" label="Role">...</ui-dropdown>
+```
+
+## Accessibility
+
+### Keyboard Navigation
+
+All components support comprehensive keyboard navigation:
+
+**Dropdown:**
+- `Arrow Down/Up` - Navigate through options
+- `Enter` - Select highlighted option and close
+- `Escape` - Close dropdown without selection
+- `Tab` - Move focus to next element
+
+**Listbox:**
+- `Arrow Down/Up` - Navigate items
+- `Home/End` - Jump to first/last item
+- `Space/Enter` - Select item
+
+**Checkbox/Checklist:**
+- `Space` - Toggle checkbox state
+- `Tab` - Move between checkboxes
+
+### ARIA Attributes
+
+Components include proper ARIA attributes for screen readers:
+
+```html
+<!-- Dropdown -->
+<ui-dropdown
+  role="combobox"
+  aria-haspopup="listbox"
+  [attr.aria-expanded]="isOpen()">
+</ui-dropdown>
+
+<!-- Listbox -->
+<div uiListbox role="listbox">
+  <div uiListboxItem role="option"></div>
+</div>
+```
+
+## Testing
+
+The library uses **Jest** with **Spectator** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test ui-input-controls --skip-nx-cache
+
+# Run tests with coverage
+npx nx test ui-input-controls --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test ui-input-controls --watch
+```
+
+### Test Coverage
+
+The library includes comprehensive unit tests covering:
+
+- **Component rendering** - All visual states and variants
+- **Form integration** - ControlValueAccessor implementation
+- **Keyboard navigation** - Arrow keys, Enter, Escape, Tab
+- **Validation** - Error states and validation display
+- **Accessibility** - ARIA attributes and screen reader support
+- **User interactions** - Click, keyboard, focus events
+
+## Architecture Notes
+
+### Design Patterns
+
+#### 1. ControlValueAccessor Pattern
+All form controls implement the CVA interface for seamless Angular Forms integration.
+
+**Benefits:**
+- Works with both reactive and template-driven forms
+- Automatic validation integration
+- Consistent API across all controls
+
+#### 2. Signal-Based Reactivity
+Components use Angular signals for reactive state management:
+
+```typescript
+appearance = input<CheckboxAppearance>(CheckboxAppearance.Checkbox);
+appearanceClass = computed(() =>
+  this.appearance() === CheckboxAppearance.Bullet
+    ? 'ui-checkbox__bullet'
+    : 'ui-checkbox__checkbox'
+);
+```
+
+#### 3. CDK Integration
+Leverages Angular CDK for complex interactions:
+
+- **Overlay** - Dropdown positioning (CdkConnectedOverlay)
+- **A11y** - Keyboard navigation (ActiveDescendantKeyManager)
+- **Listbox** - Accessible list selection (CdkListbox)
+
+### Performance Considerations
+
+1. **OnPush Change Detection** - All components use OnPush strategy
+2. **Signal Reactivity** - Computed signals prevent unnecessary re-renders
+3. **KeyManager** - Efficient keyboard navigation without DOM queries
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework
+- `@angular/forms` - Forms module
+- `@angular/cdk/a11y` - Accessibility utilities
+- `@angular/cdk/listbox` - Listbox primitive
+- `@angular/cdk/overlay` - Overlay positioning
+- `@angular/cdk/collections` - SelectionModel
+- `@ng-icons/core` - Icon system
+- `@isa/icons` - ISA icon library
+- `lodash` - Utility functions (isEqual)
+
+### Path Alias
+
+Import from: `@isa/ui/input-controls`
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/ui/item-rows/README.md b/libs/ui/item-rows/README.md
index 8555e6195..bb286e156 100644
--- a/libs/ui/item-rows/README.md
+++ b/libs/ui/item-rows/README.md
@@ -1,7 +1,1124 @@
-# ui-item-rows
+# @isa/ui/item-rows
 
-This library was generated with [Nx](https://nx.dev).
+A collection of reusable row components for displaying structured data with consistent layouts across Angular applications.
 
-## Running unit tests
+## Overview
 
-Run `nx test ui-item-rows` to execute the unit tests.
+The Item Rows UI library provides three specialized row components for presenting structured information in a consistent, accessible format. These components enable standardized display of product items, client information, and key-value data pairs throughout the ISA application. Each component uses content projection and directive-based composition for maximum flexibility while maintaining design system consistency.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Styling and Customization](#styling-and-customization)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Three row components** - ItemRowComponent, ItemRowDataComponent, and ClientRowComponent
+- **Directive-based composition** - Flexible data organization with semantic directives
+- **Content projection** - Full control over row content via ng-content
+- **Convenience imports** - Pre-bundled directive arrays for easy imports
+- **OnPush change detection** - Optimized rendering performance
+- **ViewEncapsulation.None** - Global styling integration with design system
+- **BEM-like CSS naming** - Predictable class structure for styling
+- **Standalone architecture** - Modern Angular components with explicit imports
+- **Type-safe directives** - Directive selectors support both attribute and element syntax
+- **SCSS integration** - Component-scoped styles with BEM conventions
+
+## Quick Start
+
+### 1. Basic Item Row
+
+```typescript
+import { Component } from '@angular/core';
+import { ItemRowComponent } from '@isa/ui/item-rows';
+
+@Component({
+  selector: 'app-product-list-item',
+  template: `
+    <ui-item-row>
+      <h3>Product Name</h3>
+      <p>Product description and details</p>
+    </ui-item-row>
+  `,
+  imports: [ItemRowComponent]
+})
+export class ProductListItemComponent {}
+```
+
+### 2. Item Row with Data Pairs
+
+```typescript
+import { Component } from '@angular/core';
+import { ItemRowDataImports } from '@isa/ui/item-rows';
+
+@Component({
+  selector: 'app-product-details',
+  template: `
+    <ui-item-row-data>
+      <div uiItemRowDataRow>
+        <span uiItemRowDataLabel>Price:</span>
+        <span uiItemRowDataValue>$29.99</span>
+      </div>
+      <div uiItemRowDataRow>
+        <span uiItemRowDataLabel>Stock:</span>
+        <span uiItemRowDataValue>In Stock</span>
+      </div>
+    </ui-item-row-data>
+  `,
+  imports: [ItemRowDataImports]
+})
+export class ProductDetailsComponent {}
+```
+
+### 3. Client Row
+
+```typescript
+import { Component } from '@angular/core';
+import { ClientRowImports } from '@isa/ui/item-rows';
+
+@Component({
+  selector: 'app-customer-card',
+  template: `
+    <ui-client-row>
+      <div uiClientRowContent>
+        <h4>Customer Name</h4>
+        <p>customer@example.com</p>
+      </div>
+    </ui-client-row>
+  `,
+  imports: [ClientRowImports]
+})
+export class CustomerCardComponent {}
+```
+
+## Core Concepts
+
+### Component Types
+
+The library provides three distinct row components, each optimized for specific use cases:
+
+#### 1. ItemRowComponent
+- **Purpose**: General-purpose row container for any item content
+- **Use Cases**: Product listings, order items, search results, general lists
+- **Structure**: Simple container with no internal layout structure
+- **CSS Class**: `ui-item-row`
+- **Selectors**: `<ui-item-row>` or `[ui-item-row]`
+
+#### 2. ItemRowDataComponent with Directives
+- **Purpose**: Key-value data presentation with label/value pairs
+- **Use Cases**: Product specifications, order details, metadata display
+- **Structure**: Hierarchical with row/label/value organization
+- **CSS Classes**:
+  - `ui-item-row-data` (container)
+  - `ui-item-row-data-row` (individual row)
+  - `ui-item-row-data-label` (left-side label)
+  - `ui-item-row-data-value` (right-side value)
+- **Directives**:
+  - `ItemRowDataComponent` - Main container
+  - `ItemRowDataRowDirective` - Individual data row
+  - `ItemRowDataLabelDirective` - Label element
+  - `ItemRowDataValueDirective` - Value element
+
+#### 3. ClientRowComponent
+- **Purpose**: Customer/client information display
+- **Use Cases**: Customer lists, client cards, user profiles
+- **Structure**: Specialized layout for client-specific content
+- **CSS Classes**:
+  - `ui-client-row` (container)
+  - `ui-client-row-content` (content wrapper)
+- **Directives**:
+  - `ClientRowComponent` - Main container
+  - `ClientRowContentDirective` - Content wrapper
+
+### Directive-Based Composition
+
+The library uses directives to create semantic, reusable layout patterns:
+
+```typescript
+// Attribute syntax (preferred)
+<div uiItemRowDataRow>
+  <span uiItemRowDataLabel>Label</span>
+  <span uiItemRowDataValue>Value</span>
+</div>
+
+// Element syntax (alternative)
+<ui-item-row-data-row>
+  <ui-item-row-data-label>Label</ui-item-row-data-label>
+  <ui-item-row-data-value>Value</ui-item-row-data-value>
+</ui-item-row-data-row>
+```
+
+**Benefits of directive composition**:
+- **Semantic HTML** - Clear intent in templates
+- **Flexible markup** - Use with any HTML element
+- **Type safety** - Directive selectors enforce correct usage
+- **Consistent styling** - Predictable CSS classes
+
+### Convenience Import Arrays
+
+The library provides pre-bundled directive arrays for simplified imports:
+
+```typescript
+// ItemRowDataImports - All data row components and directives
+export const ItemRowDataImports = [
+  ItemRowDataComponent,
+  ItemRowDataLabelDirective,
+  ItemRowDataValueDirective,
+  ItemRowDataRowDirective,
+];
+
+// ClientRowImports - Client row component and content directive
+export const ClientRowImports = [
+  ClientRowComponent,
+  ClientRowContentDirective
+];
+```
+
+**Usage:**
+```typescript
+@Component({
+  // Import entire directive family at once
+  imports: [ItemRowDataImports]
+})
+```
+
+## API Reference
+
+### ItemRowComponent
+
+Basic row container for general item display.
+
+#### Selector
+```html
+<ui-item-row>Content</ui-item-row>
+<!-- OR -->
+<div ui-item-row>Content</div>
+```
+
+#### Properties
+- **No inputs** - Pure container component
+- **Host class**: `ui-item-row`
+- **Change Detection**: OnPush
+- **Encapsulation**: None
+
+#### Template
+```html
+<ng-content></ng-content>
+```
+
+#### Example
+```html
+<ui-item-row>
+  <div class="product-header">
+    <h3>Product Title</h3>
+    <span class="price">$99.99</span>
+  </div>
+  <p class="description">Product description text</p>
+</ui-item-row>
+```
+
+### ItemRowDataComponent
+
+Container for key-value data pairs with semantic directives.
+
+#### Selector
+```html
+<ui-item-row-data>Content</ui-item-row-data>
+```
+
+#### Properties
+- **No inputs** - Container with directive-based children
+- **Host class**: `ui-item-row-data`
+- **Change Detection**: OnPush
+- **Encapsulation**: None
+
+#### Template
+```html
+<ng-content></ng-content>
+```
+
+#### Example
+```html
+<ui-item-row-data>
+  <div uiItemRowDataRow>
+    <span uiItemRowDataLabel>SKU:</span>
+    <span uiItemRowDataValue>ABC-12345</span>
+  </div>
+</ui-item-row-data>
+```
+
+### ItemRowDataRowDirective
+
+Marks an element as a data row within ItemRowDataComponent.
+
+#### Selectors
+```html
+<div uiItemRowDataRow>Content</div>
+<!-- OR -->
+<ui-item-row-data-row>Content</ui-item-row-data-row>
+```
+
+#### Properties
+- **No inputs** - Structural directive
+- **Host class**: `ui-item-row-data-row`
+
+#### Example
+```html
+<div uiItemRowDataRow>
+  <span uiItemRowDataLabel>Weight:</span>
+  <span uiItemRowDataValue>2.5 kg</span>
+</div>
+```
+
+### ItemRowDataLabelDirective
+
+Marks an element as a label (left side) in a data row.
+
+#### Selectors
+```html
+<span uiItemRowDataLabel>Label Text</span>
+<!-- OR -->
+<ui-item-row-data-label>Label Text</ui-item-row-data-label>
+```
+
+#### Properties
+- **No inputs** - Structural directive
+- **Host class**: `ui-item-row-data-label`
+
+#### Example
+```html
+<span uiItemRowDataLabel>Category:</span>
+```
+
+### ItemRowDataValueDirective
+
+Marks an element as a value (right side) in a data row.
+
+#### Selectors
+```html
+<span uiItemRowDataValue>Value Text</span>
+<!-- OR -->
+<ui-item-row-data-value>Value Text</ui-item-row-data-value>
+```
+
+#### Properties
+- **No inputs** - Structural directive
+- **Host class**: `ui-item-row-data-value`
+
+#### Example
+```html
+<span uiItemRowDataValue>Electronics</span>
+```
+
+### ClientRowComponent
+
+Specialized row component for client/customer information.
+
+#### Selector
+```html
+<ui-client-row>Content</ui-client-row>
+```
+
+#### Properties
+- **No inputs** - Container component
+- **Host class**: `ui-client-row`
+- **Change Detection**: OnPush
+- **Encapsulation**: None
+- **Standalone**: true
+
+#### Template
+```html
+<ng-content></ng-content>
+```
+
+#### Example
+```html
+<ui-client-row>
+  <div uiClientRowContent>
+    <h4>John Doe</h4>
+    <p>john.doe@example.com</p>
+  </div>
+</ui-client-row>
+```
+
+### ClientRowContentDirective
+
+Marks an element as content within ClientRowComponent.
+
+#### Selectors
+```html
+<div uiClientRowContent>Content</div>
+<!-- OR -->
+<ui-client-row-content>Content</ui-client-row-content>
+```
+
+#### Properties
+- **No inputs** - Structural directive
+- **Host class**: `ui-client-row-content`
+
+#### Example
+```html
+<div uiClientRowContent>
+  <div class="client-info">
+    <span class="client-name">Jane Smith</span>
+    <span class="client-id">#12345</span>
+  </div>
+</div>
+```
+
+### Convenience Import Arrays
+
+#### ItemRowDataImports
+Bundle of all data row components and directives.
+
+```typescript
+export const ItemRowDataImports = [
+  ItemRowDataComponent,
+  ItemRowDataLabelDirective,
+  ItemRowDataValueDirective,
+  ItemRowDataRowDirective,
+];
+```
+
+**Usage:**
+```typescript
+@Component({
+  imports: [ItemRowDataImports]
+})
+```
+
+#### ClientRowImports
+Bundle of client row component and directive.
+
+```typescript
+export const ClientRowImports = [
+  ClientRowComponent,
+  ClientRowContentDirective
+];
+```
+
+**Usage:**
+```typescript
+@Component({
+  imports: [ClientRowImports]
+})
+```
+
+## Usage Examples
+
+### Product Information Display
+
+```typescript
+import { Component, input } from '@angular/core';
+import { ItemRowComponent, ItemRowDataImports } from '@isa/ui/item-rows';
+
+interface Product {
+  id: number;
+  name: string;
+  sku: string;
+  price: number;
+  stock: number;
+  category: string;
+}
+
+@Component({
+  selector: 'app-product-info',
+  template: `
+    <ui-item-row>
+      <h3>{{ product().name }}</h3>
+
+      <ui-item-row-data>
+        <div uiItemRowDataRow>
+          <span uiItemRowDataLabel>SKU:</span>
+          <span uiItemRowDataValue>{{ product().sku }}</span>
+        </div>
+
+        <div uiItemRowDataRow>
+          <span uiItemRowDataLabel>Price:</span>
+          <span uiItemRowDataValue>\${{ product().price }}</span>
+        </div>
+
+        <div uiItemRowDataRow>
+          <span uiItemRowDataLabel>Stock:</span>
+          <span uiItemRowDataValue>{{ product().stock }} units</span>
+        </div>
+
+        <div uiItemRowDataRow>
+          <span uiItemRowDataLabel>Category:</span>
+          <span uiItemRowDataValue>{{ product().category }}</span>
+        </div>
+      </ui-item-row-data>
+    </ui-item-row>
+  `,
+  imports: [ItemRowComponent, ItemRowDataImports]
+})
+export class ProductInfoComponent {
+  product = input.required<Product>();
+}
+```
+
+### Order Details List
+
+```typescript
+import { Component, input } from '@angular/core';
+import { ItemRowDataImports } from '@isa/ui/item-rows';
+import { DatePipe, CurrencyPipe } from '@angular/common';
+
+interface Order {
+  orderNumber: string;
+  date: Date;
+  status: string;
+  total: number;
+  shippingMethod: string;
+}
+
+@Component({
+  selector: 'app-order-details',
+  template: `
+    <ui-item-row-data>
+      <div uiItemRowDataRow>
+        <span uiItemRowDataLabel>Order Number:</span>
+        <strong uiItemRowDataValue>{{ order().orderNumber }}</strong>
+      </div>
+
+      <div uiItemRowDataRow>
+        <span uiItemRowDataLabel>Order Date:</span>
+        <span uiItemRowDataValue>{{ order().date | date:'short' }}</span>
+      </div>
+
+      <div uiItemRowDataRow>
+        <span uiItemRowDataLabel>Status:</span>
+        <span uiItemRowDataValue class="status-{{ order().status }}">
+          {{ order().status }}
+        </span>
+      </div>
+
+      <div uiItemRowDataRow>
+        <span uiItemRowDataLabel>Total:</span>
+        <span uiItemRowDataValue>{{ order().total | currency }}</span>
+      </div>
+
+      <div uiItemRowDataRow>
+        <span uiItemRowDataLabel>Shipping:</span>
+        <span uiItemRowDataValue>{{ order().shippingMethod }}</span>
+      </div>
+    </ui-item-row-data>
+  `,
+  imports: [ItemRowDataImports, DatePipe, CurrencyPipe]
+})
+export class OrderDetailsComponent {
+  order = input.required<Order>();
+}
+```
+
+### Customer List with Client Rows
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { ClientRowImports } from '@isa/ui/item-rows';
+
+interface Customer {
+  id: number;
+  name: string;
+  email: string;
+  phone: string;
+  company: string;
+}
+
+@Component({
+  selector: 'app-customer-list',
+  template: `
+    <div class="customer-list">
+      @for (customer of customers(); track customer.id) {
+        <ui-client-row>
+          <div uiClientRowContent class="customer-card">
+            <div class="customer-header">
+              <h4>{{ customer.name }}</h4>
+              <span class="customer-id">#{{ customer.id }}</span>
+            </div>
+            <div class="customer-details">
+              <p>{{ customer.email }}</p>
+              <p>{{ customer.phone }}</p>
+              <p class="company">{{ customer.company }}</p>
+            </div>
+          </div>
+        </ui-client-row>
+      }
+    </div>
+  `,
+  imports: [ClientRowImports],
+  styles: [`
+    .customer-list {
+      display: flex;
+      flex-direction: column;
+      gap: 1rem;
+    }
+
+    .customer-card {
+      padding: 1rem;
+    }
+
+    .customer-header {
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+      margin-bottom: 0.5rem;
+    }
+
+    .company {
+      color: var(--isa-text-secondary);
+      font-size: 0.875rem;
+    }
+  `]
+})
+export class CustomerListComponent {
+  customers = signal<Customer[]>([
+    {
+      id: 1,
+      name: 'John Doe',
+      email: 'john@example.com',
+      phone: '+1 555-0100',
+      company: 'Acme Corp'
+    },
+    // ... more customers
+  ]);
+}
+```
+
+### Mixed Content with Conditional Rendering
+
+```typescript
+import { Component, input, computed } from '@angular/core';
+import { ItemRowComponent, ItemRowDataImports } from '@isa/ui/item-rows';
+
+interface ProductWithVariants {
+  name: string;
+  basePrice: number;
+  hasVariants: boolean;
+  variants?: Array<{ name: string; price: number }>;
+  specifications: Record<string, string>;
+}
+
+@Component({
+  selector: 'app-product-variant-info',
+  template: `
+    <ui-item-row>
+      <h3>{{ product().name }}</h3>
+
+      @if (product().hasVariants) {
+        <div class="variants">
+          @for (variant of product().variants; track variant.name) {
+            <span class="variant-chip">
+              {{ variant.name }} - \${{ variant.price }}
+            </span>
+          }
+        </div>
+      }
+
+      <ui-item-row-data>
+        @for (spec of specificationEntries(); track spec.key) {
+          <div uiItemRowDataRow>
+            <span uiItemRowDataLabel>{{ spec.key }}:</span>
+            <span uiItemRowDataValue>{{ spec.value }}</span>
+          </div>
+        }
+      </ui-item-row-data>
+    </ui-item-row>
+  `,
+  imports: [ItemRowComponent, ItemRowDataImports]
+})
+export class ProductVariantInfoComponent {
+  product = input.required<ProductWithVariants>();
+
+  specificationEntries = computed(() =>
+    Object.entries(this.product().specifications).map(([key, value]) => ({
+      key,
+      value
+    }))
+  );
+}
+```
+
+### Nested Row Structures
+
+```typescript
+import { Component } from '@angular/core';
+import { ItemRowComponent, ItemRowDataImports } from '@isa/ui/item-rows';
+
+@Component({
+  selector: 'app-order-item-detail',
+  template: `
+    <ui-item-row class="order-item">
+      <!-- Product header -->
+      <div class="item-header">
+        <h4>Wireless Headphones</h4>
+        <span class="quantity">Qty: 2</span>
+      </div>
+
+      <!-- Primary product details -->
+      <ui-item-row-data class="primary-details">
+        <div uiItemRowDataRow>
+          <span uiItemRowDataLabel>Unit Price:</span>
+          <span uiItemRowDataValue>$79.99</span>
+        </div>
+
+        <div uiItemRowDataRow>
+          <span uiItemRowDataLabel>Subtotal:</span>
+          <span uiItemRowDataValue>$159.98</span>
+        </div>
+      </ui-item-row-data>
+
+      <!-- Shipping information -->
+      <ui-item-row-data class="shipping-details">
+        <div uiItemRowDataRow>
+          <span uiItemRowDataLabel>Estimated Delivery:</span>
+          <span uiItemRowDataValue>Dec 25, 2025</span>
+        </div>
+
+        <div uiItemRowDataRow>
+          <span uiItemRowDataLabel>Shipping Method:</span>
+          <span uiItemRowDataValue>Standard (3-5 days)</span>
+        </div>
+      </ui-item-row-data>
+    </ui-item-row>
+  `,
+  imports: [ItemRowComponent, ItemRowDataImports]
+})
+export class OrderItemDetailComponent {}
+```
+
+### Dynamic Data Rows
+
+```typescript
+import { Component, input, computed } from '@angular/core';
+import { ItemRowDataImports } from '@isa/ui/item-rows';
+
+@Component({
+  selector: 'app-dynamic-metadata',
+  template: `
+    <ui-item-row-data>
+      @for (field of metadataFields(); track field.key) {
+        <div uiItemRowDataRow>
+          <span uiItemRowDataLabel>{{ field.label }}:</span>
+          <span
+            uiItemRowDataValue
+            [class]="field.highlightClass">
+            {{ field.value }}
+          </span>
+        </div>
+      }
+    </ui-item-row-data>
+  `,
+  imports: [ItemRowDataImports]
+})
+export class DynamicMetadataComponent {
+  metadata = input.required<Record<string, any>>();
+
+  metadataFields = computed(() => {
+    const data = this.metadata();
+    return Object.entries(data).map(([key, value]) => ({
+      key,
+      label: this.formatLabel(key),
+      value: this.formatValue(value),
+      highlightClass: this.getHighlightClass(key, value)
+    }));
+  });
+
+  private formatLabel(key: string): string {
+    return key
+      .replace(/([A-Z])/g, ' $1')
+      .replace(/^./, str => str.toUpperCase());
+  }
+
+  private formatValue(value: any): string {
+    if (typeof value === 'boolean') return value ? 'Yes' : 'No';
+    if (value === null || value === undefined) return 'N/A';
+    return String(value);
+  }
+
+  private getHighlightClass(key: string, value: any): string {
+    if (key === 'status') {
+      return value === 'active' ? 'text-success' : 'text-muted';
+    }
+    return '';
+  }
+}
+```
+
+## Styling and Customization
+
+### CSS Class Structure
+
+The components generate predictable BEM-like class structures:
+
+```css
+/* ItemRowComponent */
+.ui-item-row {
+  /* Base item row styles */
+  display: block;
+  padding: 1rem;
+  border-bottom: 1px solid var(--isa-border-color);
+}
+
+/* ItemRowDataComponent */
+.ui-item-row-data {
+  /* Container for data rows */
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.ui-item-row-data-row {
+  /* Individual data row */
+  display: grid;
+  grid-template-columns: minmax(120px, 1fr) 2fr;
+  gap: 1rem;
+  align-items: start;
+}
+
+.ui-item-row-data-label {
+  /* Label (left column) */
+  font-weight: 500;
+  color: var(--isa-text-secondary);
+  text-align: left;
+}
+
+.ui-item-row-data-value {
+  /* Value (right column) */
+  color: var(--isa-text-primary);
+  text-align: left;
+}
+
+/* ClientRowComponent */
+.ui-client-row {
+  /* Client row container */
+  display: block;
+  background-color: var(--isa-surface);
+  border-radius: 8px;
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
+}
+
+.ui-client-row-content {
+  /* Client row content wrapper */
+  padding: 1.5rem;
+}
+```
+
+### Custom Styling Examples
+
+```scss
+// Custom product row styling
+.product-listing {
+  ui-item-row {
+    background-color: white;
+    border-radius: 4px;
+    margin-bottom: 1rem;
+    transition: box-shadow 0.2s;
+
+    &:hover {
+      box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+    }
+  }
+
+  .ui-item-row-data {
+    margin-top: 1rem;
+    padding-top: 1rem;
+    border-top: 1px solid var(--isa-border-color);
+  }
+
+  .ui-item-row-data-label {
+    font-size: 0.875rem;
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+  }
+
+  .ui-item-row-data-value {
+    font-weight: 600;
+  }
+}
+
+// Custom client row styling
+.customer-directory {
+  ui-client-row {
+    margin-bottom: 1rem;
+    border: 1px solid var(--isa-border-light);
+
+    &:hover {
+      border-color: var(--isa-brand-primary);
+      box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+    }
+  }
+
+  .ui-client-row-content {
+    display: grid;
+    grid-template-columns: auto 1fr;
+    gap: 1rem;
+    align-items: center;
+  }
+}
+```
+
+### Responsive Layouts
+
+```css
+/* Mobile-first responsive data rows */
+.ui-item-row-data-row {
+  /* Stack on mobile */
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+}
+
+@media (min-width: 640px) {
+  .ui-item-row-data-row {
+    /* Side-by-side on tablet and up */
+    flex-direction: row;
+    justify-content: space-between;
+  }
+}
+
+@media (min-width: 1024px) {
+  .ui-item-row-data-row {
+    /* Grid layout on desktop */
+    display: grid;
+    grid-template-columns: minmax(150px, 1fr) 3fr;
+  }
+}
+```
+
+### Tailwind CSS Integration
+
+```html
+<!-- Using Tailwind classes with item rows -->
+<ui-item-row class="p-4 mb-4 bg-white rounded-lg shadow-sm hover:shadow-md transition-shadow">
+  <ui-item-row-data class="space-y-2">
+    <div uiItemRowDataRow class="grid grid-cols-2 gap-4">
+      <span uiItemRowDataLabel class="text-sm font-medium text-gray-600">
+        Label
+      </span>
+      <span uiItemRowDataValue class="text-base text-gray-900">
+        Value
+      </span>
+    </div>
+  </ui-item-row-data>
+</ui-item-row>
+```
+
+## Testing
+
+The library uses **Jest** for testing (legacy setup - migration to Vitest pending).
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test ui-item-rows --skip-nx-cache
+
+# Run tests with coverage
+npx nx test ui-item-rows --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test ui-item-rows --watch
+```
+
+### Test Structure
+
+The library should include tests covering:
+
+- **Component rendering** - Verify components render correctly
+- **Content projection** - Test ng-content works as expected
+- **Directive application** - Verify CSS classes are applied correctly
+- **Host bindings** - Test host class bindings
+- **Nested structures** - Test complex nesting scenarios
+
+### Example Test
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach } from '@jest/globals';
+import {
+  ItemRowDataComponent,
+  ItemRowDataRowDirective,
+  ItemRowDataLabelDirective,
+  ItemRowDataValueDirective
+} from './item-row-data.component';
+
+describe('ItemRowDataComponent', () => {
+  let component: ItemRowDataComponent;
+  let fixture: ComponentFixture<ItemRowDataComponent>;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      imports: [
+        ItemRowDataComponent,
+        ItemRowDataRowDirective,
+        ItemRowDataLabelDirective,
+        ItemRowDataValueDirective
+      ]
+    });
+    fixture = TestBed.createComponent(ItemRowDataComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+
+  it('should have ui-item-row-data class', () => {
+    const element = fixture.nativeElement as HTMLElement;
+    expect(element.classList.contains('ui-item-row-data')).toBe(true);
+  });
+
+  it('should project content', () => {
+    const compiled = fixture.nativeElement as HTMLElement;
+    const testContent = '<div>Test Content</div>';
+    compiled.innerHTML = testContent;
+    fixture.detectChanges();
+    expect(compiled.innerHTML).toContain('Test Content');
+  });
+});
+```
+
+## Architecture Notes
+
+### Current Architecture
+
+The library follows a directive-based composition pattern:
+
+```
+ItemRowComponent (Simple Container)
+├── No inputs, pure content projection
+└── CSS: ui-item-row
+
+ItemRowDataComponent (Data Container)
+├── No inputs, container for data rows
+├── CSS: ui-item-row-data
+└── Works with directives:
+    ├── ItemRowDataRowDirective (row wrapper)
+    ├── ItemRowDataLabelDirective (label/key)
+    └── ItemRowDataValueDirective (value)
+
+ClientRowComponent (Client Container)
+├── No inputs, specialized for clients
+├── CSS: ui-client-row
+└── Works with directive:
+    └── ClientRowContentDirective (content wrapper)
+```
+
+### Design Decisions
+
+#### 1. Directive-Based Composition
+
+**Decision**: Use directives instead of child components for layout structure
+**Rationale**:
+- Flexibility to use any HTML element (div, span, p, etc.)
+- Semantic selectors (`uiItemRowDataLabel` vs generic component)
+- Lighter weight than full components
+- Easier to apply to existing markup
+
+**Impact**: More flexible templates with clear semantic meaning
+
+#### 2. Dual Selector Support
+
+**Decision**: Support both attribute and element selectors
+**Rationale**:
+- `[uiItemRowDataRow]` - Attribute syntax for flexible element types
+- `<ui-item-row-data-row>` - Element syntax for clarity
+- Developers can choose based on preference and context
+- Consistent with Angular best practices
+
+**Impact**: Better developer experience with choice of syntax
+
+#### 3. Convenience Import Arrays
+
+**Decision**: Export pre-bundled directive arrays
+**Rationale**:
+- Reduces boilerplate in component imports
+- Ensures all related directives are imported together
+- Clear API - import array, not individual directives
+- Prevents missing directive errors
+
+**Impact**: Simpler, more maintainable component declarations
+
+#### 4. No Component Inputs
+
+**Decision**: Components have no @Input properties
+**Rationale**:
+- Pure structural components focused on layout
+- Content and styling controlled via projection and CSS
+- Simpler API with fewer configuration options
+- Promotes composition over configuration
+
+**Impact**: Simpler components, styling handled via CSS
+
+#### 5. ViewEncapsulation.None
+
+**Decision**: Use ViewEncapsulation.None for global CSS classes
+**Rationale**:
+- Consistent with ISA design system approach
+- BEM-like naming prevents conflicts
+- Easier theming and customization
+- Works well with Tailwind utility classes
+
+**Impact**: Flexible styling with global CSS classes
+
+### Migration Considerations
+
+#### Testing Framework Migration (Pending)
+
+**Current State**: Uses Jest
+**Target**: Migrate to Vitest + Angular Testing Utilities
+**Reason**: Aligns with ISA codebase standards (13 libraries already migrated)
+**Priority**: Low - works well with Jest currently
+
+**Migration steps when ready**:
+1. Update project.json to use @nx/vite:test
+2. Add vite.config.mts
+3. Convert tests to use Vitest imports
+4. Update test setup files
+
+### Performance Considerations
+
+1. **OnPush change detection** - Minimal overhead for structural components
+2. **No reactive inputs** - No signal overhead
+3. **Simple templates** - Just ng-content projection
+4. **Directive overhead** - Minimal, just CSS class application
+5. **No JavaScript logic** - Pure presentational components
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Icon Support** - Add optional icon directives for labels
+2. **Accordion Behavior** - Collapsible row variants
+3. **Selection Support** - Checkbox/radio integration
+4. **Loading States** - Skeleton variants for data rows
+5. **Empty States** - Placeholder content when no data
+6. **Accessibility** - ARIA attributes for screen readers
+7. **Animation Support** - Entry/exit animations for rows
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework (20.1.2)
+- `@angular/common` - CommonModule (implicitly used)
+
+### Optional Libraries
+
+None - pure presentation components with no external dependencies.
+
+### Path Alias
+
+Import from: `@isa/ui/item-rows`
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/ui/label/README.md b/libs/ui/label/README.md
index 9bbf413e6..26eae104b 100644
--- a/libs/ui/label/README.md
+++ b/libs/ui/label/README.md
@@ -1,7 +1,813 @@
-# label
+# @isa/ui/label
 
-This library was generated with [Nx](https://nx.dev).
+A flexible label component for displaying tags and notices with configurable priority levels across Angular applications.
 
-## Running unit tests
+## Overview
 
-Run `nx test label` to execute the unit tests.
+The Label UI library provides a standalone Angular component for displaying visual labels with semantic meaning. It supports two distinct label types (Tag and Notice) and three priority levels (High, Medium, Low), enabling consistent visual communication of information status, categorization, and importance throughout the ISA application.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Styling and Customization](#styling-and-customization)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Two label types** - Tag and Notice for different semantic contexts
+- **Three priority levels** - High, Medium, and Low for visual hierarchy
+- **Standalone component** - Modern Angular architecture with explicit imports
+- **Signal-based reactivity** - Uses Angular signals for efficient updates
+- **Type-safe API** - TypeScript enums for label type and priority configuration
+- **CSS class composition** - Dynamic class generation based on type and priority
+- **OnPush change detection** - Optimized rendering performance
+- **ViewEncapsulation.None** - Flexible styling with global CSS classes
+- **Content projection** - Full control over label content via ng-content
+- **Computed classes** - Reactive CSS class computation using Angular signals
+
+## Quick Start
+
+### 1. Import the Component
+
+```typescript
+import { Component } from '@angular/core';
+import { LabelComponent, Labeltype, LabelPriority } from '@isa/ui/label';
+
+@Component({
+  selector: 'app-product-status',
+  template: `
+    <ui-label [type]="Labeltype.Tag" [priority]="LabelPriority.High">
+      In Stock
+    </ui-label>
+  `,
+  imports: [LabelComponent]
+})
+export class ProductStatusComponent {
+  Labeltype = Labeltype;
+  LabelPriority = LabelPriority;
+}
+```
+
+### 2. Basic Tag Label
+
+```typescript
+@Component({
+  template: `
+    <ui-label [type]="Labeltype.Tag" [priority]="LabelPriority.Medium">
+      New Arrival
+    </ui-label>
+  `,
+  imports: [LabelComponent]
+})
+export class ProductBadgeComponent {
+  Labeltype = Labeltype;
+  LabelPriority = LabelPriority;
+}
+```
+
+### 3. Notice Label
+
+```typescript
+@Component({
+  template: `
+    <ui-label [type]="Labeltype.Notice" [priority]="LabelPriority.High">
+      Action Required
+    </ui-label>
+  `,
+  imports: [LabelComponent]
+})
+export class AlertComponent {
+  Labeltype = Labeltype;
+  LabelPriority = LabelPriority;
+}
+```
+
+## Core Concepts
+
+### Label Types
+
+The component supports two distinct label types, each with specific semantic meaning:
+
+#### 1. Tag (Default)
+- **Purpose**: Categorization, status indication, metadata display
+- **Use Cases**: Product categories, order status, item tags, filters
+- **Visual Style**: Typically compact, pill-shaped design
+- **CSS Class**: `ui-label__tag`
+
+#### 2. Notice
+- **Purpose**: Notifications, alerts, important messages
+- **Use Cases**: Error messages, warnings, system notifications, user alerts
+- **Visual Style**: Typically more prominent, attention-grabbing design
+- **CSS Class**: `ui-label__notice`
+
+### Priority Levels
+
+Each label type can have one of three priority levels that control visual hierarchy:
+
+#### 1. High Priority (Default)
+- **Purpose**: Critical information, urgent status, primary actions
+- **Visual Characteristics**: Most prominent styling, often with bold colors
+- **Use Cases**: Error states, critical alerts, primary status
+- **CSS Classes**:
+  - `ui-label__tag-priority-high` (for Tag type)
+  - `ui-label__notice-priority-high` (for Notice type)
+
+#### 2. Medium Priority
+- **Purpose**: Important but non-critical information
+- **Visual Characteristics**: Moderate emphasis, balanced contrast
+- **Use Cases**: Warnings, secondary status, informational notices
+- **CSS Classes**:
+  - `ui-label__tag-priority-medium` (for Tag type)
+  - `ui-label__notice-priority-medium` (for Notice type)
+
+#### 3. Low Priority
+- **Purpose**: Supplementary information, subtle indicators
+- **Visual Characteristics**: Minimal emphasis, subtle colors
+- **Use Cases**: Hints, optional metadata, background information
+- **CSS Classes**:
+  - `ui-label__tag-priority-low` (for Tag type)
+  - `ui-label__notice-priority-low` (for Notice type)
+
+### Signal-Based Reactivity
+
+The component uses Angular signals for reactive CSS class computation:
+
+```typescript
+// Signal inputs
+type = input<Labeltype>(Labeltype.Tag);
+priority = input<LabelPriority>(LabelPriority.High);
+
+// Computed signal for type class
+typeClass = computed(() => `ui-label__${this.type()}`);
+
+// Computed signal for priority class (combines type and priority)
+priorityClass = computed(() => `${this.typeClass()}-priority-${this.priority()}`);
+```
+
+This approach provides:
+- **Automatic updates** - Classes update when inputs change
+- **Efficient rendering** - Only recomputes when dependencies change
+- **Type safety** - TypeScript ensures valid type/priority combinations
+
+### CSS Class Structure
+
+The component applies a hierarchical class structure:
+
+```
+ui-label                                  (base class)
+├── ui-label__tag                         (type class for Tag)
+│   ├── ui-label__tag-priority-high       (Tag + High priority)
+│   ├── ui-label__tag-priority-medium     (Tag + Medium priority)
+│   └── ui-label__tag-priority-low        (Tag + Low priority)
+└── ui-label__notice                      (type class for Notice)
+    ├── ui-label__notice-priority-high    (Notice + High priority)
+    ├── ui-label__notice-priority-medium  (Notice + Medium priority)
+    └── ui-label__notice-priority-low     (Notice + Low priority)
+```
+
+## API Reference
+
+### LabelComponent
+
+Standalone component for displaying labels with type and priority.
+
+#### Selector
+```html
+<ui-label>Content</ui-label>
+```
+
+#### Inputs
+
+##### `type`
+- **Type**: `Labeltype`
+- **Default**: `Labeltype.Tag`
+- **Description**: The semantic type of the label
+- **Values**:
+  - `Labeltype.Tag` - For categorization and status
+  - `Labeltype.Notice` - For notifications and alerts
+
+**Example:**
+```html
+<ui-label [type]="Labeltype.Notice">Important Notice</ui-label>
+```
+
+##### `priority`
+- **Type**: `LabelPriority`
+- **Default**: `LabelPriority.High`
+- **Description**: The visual priority level of the label
+- **Values**:
+  - `LabelPriority.High` - Highest visual emphasis
+  - `LabelPriority.Medium` - Moderate visual emphasis
+  - `LabelPriority.Low` - Subtle visual emphasis
+
+**Example:**
+```html
+<ui-label [priority]="LabelPriority.Medium">Optional Info</ui-label>
+```
+
+#### Computed Properties
+
+##### `typeClass()`
+- **Type**: `Signal<string>`
+- **Returns**: CSS class string based on current type
+- **Format**: `ui-label__${type}`
+- **Example**: `"ui-label__tag"` or `"ui-label__notice"`
+
+##### `priorityClass()`
+- **Type**: `Signal<string>`
+- **Returns**: CSS class string combining type and priority
+- **Format**: `ui-label__${type}-priority-${priority}`
+- **Example**: `"ui-label__tag-priority-high"`
+
+#### Host Classes
+
+The component automatically applies the following classes to its host element:
+
+```typescript
+['ui-label', typeClass(), priorityClass()]
+```
+
+Example rendered classes:
+```html
+<ui-label class="ui-label ui-label__tag ui-label__tag-priority-high">
+  Content
+</ui-label>
+```
+
+### Type Definitions
+
+#### Labeltype
+
+TypeScript enum for label type values:
+
+```typescript
+export const Labeltype = {
+  Tag: 'tag',
+  Notice: 'notice',
+} as const;
+
+export type Labeltype = (typeof Labeltype)[keyof typeof Labeltype];
+```
+
+**Usage:**
+```typescript
+import { Labeltype } from '@isa/ui/label';
+
+// In template
+[type]="Labeltype.Tag"
+[type]="Labeltype.Notice"
+
+// In component class
+readonly labelType = Labeltype.Tag;
+```
+
+#### LabelPriority
+
+TypeScript enum for priority level values:
+
+```typescript
+export const LabelPriority = {
+  High: 'high',
+  Medium: 'medium',
+  Low: 'low',
+} as const;
+
+export type LabelPriority = (typeof LabelPriority)[keyof typeof LabelPriority];
+```
+
+**Usage:**
+```typescript
+import { LabelPriority } from '@isa/ui/label';
+
+// In template
+[priority]="LabelPriority.High"
+[priority]="LabelPriority.Medium"
+[priority]="LabelPriority.Low"
+
+// In component class
+readonly priority = LabelPriority.Medium;
+```
+
+## Usage Examples
+
+### Product Status Tags
+
+```typescript
+import { Component } from '@angular/core';
+import { LabelComponent, Labeltype, LabelPriority } from '@isa/ui/label';
+
+@Component({
+  selector: 'app-product-card',
+  template: `
+    <div class="product-card">
+      <h3>{{ product.name }}</h3>
+
+      <!-- In Stock - High priority tag -->
+      <ui-label
+        [type]="Labeltype.Tag"
+        [priority]="LabelPriority.High">
+        In Stock
+      </ui-label>
+
+      <!-- Category - Medium priority tag -->
+      <ui-label
+        [type]="Labeltype.Tag"
+        [priority]="LabelPriority.Medium">
+        Electronics
+      </ui-label>
+
+      <!-- Condition - Low priority tag -->
+      <ui-label
+        [type]="Labeltype.Tag"
+        [priority]="LabelPriority.Low">
+        New
+      </ui-label>
+    </div>
+  `,
+  imports: [LabelComponent]
+})
+export class ProductCardComponent {
+  Labeltype = Labeltype;
+  LabelPriority = LabelPriority;
+
+  product = {
+    name: 'Wireless Headphones',
+    inStock: true,
+    category: 'Electronics'
+  };
+}
+```
+
+### Order Status Indicators
+
+```typescript
+import { Component, input, computed } from '@angular/core';
+import { LabelComponent, Labeltype, LabelPriority } from '@isa/ui/label';
+
+@Component({
+  selector: 'app-order-status',
+  template: `
+    <ui-label
+      [type]="Labeltype.Tag"
+      [priority]="statusPriority()">
+      {{ statusText() }}
+    </ui-label>
+  `,
+  imports: [LabelComponent]
+})
+export class OrderStatusComponent {
+  Labeltype = Labeltype;
+
+  status = input.required<'pending' | 'processing' | 'shipped' | 'delivered'>();
+
+  statusText = computed(() => {
+    const statusMap = {
+      pending: 'Pending',
+      processing: 'Processing',
+      shipped: 'Shipped',
+      delivered: 'Delivered'
+    };
+    return statusMap[this.status()];
+  });
+
+  statusPriority = computed(() => {
+    const priorityMap = {
+      pending: LabelPriority.High,
+      processing: LabelPriority.High,
+      shipped: LabelPriority.Medium,
+      delivered: LabelPriority.Low
+    };
+    return priorityMap[this.status()];
+  });
+}
+```
+
+### System Notifications
+
+```typescript
+import { Component, input } from '@angular/core';
+import { LabelComponent, Labeltype, LabelPriority } from '@isa/ui/label';
+
+interface Notification {
+  id: number;
+  message: string;
+  type: 'error' | 'warning' | 'info';
+}
+
+@Component({
+  selector: 'app-notification-item',
+  template: `
+    <div class="notification">
+      <ui-label
+        [type]="Labeltype.Notice"
+        [priority]="getNotificationPriority()">
+        {{ getNotificationLabel() }}
+      </ui-label>
+      <p>{{ notification().message }}</p>
+    </div>
+  `,
+  imports: [LabelComponent]
+})
+export class NotificationItemComponent {
+  Labeltype = Labeltype;
+  LabelPriority = LabelPriority;
+
+  notification = input.required<Notification>();
+
+  getNotificationPriority(): LabelPriority {
+    const type = this.notification().type;
+    switch (type) {
+      case 'error':
+        return LabelPriority.High;
+      case 'warning':
+        return LabelPriority.Medium;
+      case 'info':
+        return LabelPriority.Low;
+    }
+  }
+
+  getNotificationLabel(): string {
+    const type = this.notification().type;
+    return type.charAt(0).toUpperCase() + type.slice(1);
+  }
+}
+```
+
+### Dynamic Labels with NgFor
+
+```typescript
+import { Component } from '@angular/core';
+import { LabelComponent, Labeltype, LabelPriority } from '@isa/ui/label';
+
+@Component({
+  selector: 'app-product-tags',
+  template: `
+    <div class="tags-container">
+      @for (tag of tags; track tag.id) {
+        <ui-label
+          [type]="Labeltype.Tag"
+          [priority]="tag.priority">
+          {{ tag.label }}
+        </ui-label>
+      }
+    </div>
+  `,
+  imports: [LabelComponent]
+})
+export class ProductTagsComponent {
+  Labeltype = Labeltype;
+
+  tags = [
+    { id: 1, label: 'Sale', priority: LabelPriority.High },
+    { id: 2, label: 'Free Shipping', priority: LabelPriority.Medium },
+    { id: 3, label: 'Eco-Friendly', priority: LabelPriority.Low },
+  ];
+}
+```
+
+### Conditional Label Display
+
+```typescript
+import { Component, input, computed } from '@angular/core';
+import { LabelComponent, Labeltype, LabelPriority } from '@isa/ui/label';
+
+@Component({
+  selector: 'app-inventory-status',
+  template: `
+    @if (showStockLabel()) {
+      <ui-label
+        [type]="Labeltype.Tag"
+        [priority]="stockPriority()">
+        {{ stockLabel() }}
+      </ui-label>
+    }
+  `,
+  imports: [LabelComponent]
+})
+export class InventoryStatusComponent {
+  Labeltype = Labeltype;
+  LabelPriority = LabelPriority;
+
+  stockQuantity = input.required<number>();
+
+  showStockLabel = computed(() => this.stockQuantity() < 10);
+
+  stockLabel = computed(() => {
+    const qty = this.stockQuantity();
+    if (qty === 0) return 'Out of Stock';
+    if (qty < 5) return 'Low Stock';
+    return 'Limited Stock';
+  });
+
+  stockPriority = computed(() => {
+    const qty = this.stockQuantity();
+    if (qty === 0) return LabelPriority.High;
+    if (qty < 5) return LabelPriority.High;
+    return LabelPriority.Medium;
+  });
+}
+```
+
+## Styling and Customization
+
+### CSS Class Hierarchy
+
+The component generates a predictable class structure for styling:
+
+```css
+/* Base class applied to all labels */
+.ui-label {
+  display: inline-block;
+  font-family: var(--isa-font-family);
+  /* Base styles */
+}
+
+/* Type-specific base styles */
+.ui-label__tag {
+  /* Tag-specific base styles */
+}
+
+.ui-label__notice {
+  /* Notice-specific base styles */
+}
+
+/* Priority-specific styles for Tags */
+.ui-label__tag-priority-high {
+  background-color: var(--isa-accent-red);
+  color: white;
+  font-weight: 600;
+}
+
+.ui-label__tag-priority-medium {
+  background-color: var(--isa-accent-yellow);
+  color: var(--isa-text-primary);
+  font-weight: 500;
+}
+
+.ui-label__tag-priority-low {
+  background-color: var(--isa-neutral-200);
+  color: var(--isa-text-secondary);
+  font-weight: 400;
+}
+
+/* Priority-specific styles for Notices */
+.ui-label__notice-priority-high {
+  border-left: 4px solid var(--isa-accent-red);
+  background-color: var(--isa-accent-red-light);
+  padding: 0.5rem 1rem;
+}
+
+.ui-label__notice-priority-medium {
+  border-left: 4px solid var(--isa-accent-yellow);
+  background-color: var(--isa-accent-yellow-light);
+  padding: 0.5rem 1rem;
+}
+
+.ui-label__notice-priority-low {
+  border-left: 4px solid var(--isa-neutral-300);
+  background-color: var(--isa-neutral-100);
+  padding: 0.5rem 1rem;
+}
+```
+
+### Custom Styling Example
+
+```scss
+// Override specific label styles
+.product-card {
+  ui-label {
+    border-radius: 4px;
+    padding: 0.25rem 0.75rem;
+    font-size: 0.875rem;
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+  }
+
+  // Custom high-priority tag style
+  .ui-label__tag-priority-high {
+    animation: pulse 2s infinite;
+  }
+
+  // Custom notice styles
+  .ui-label__notice {
+    box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+  }
+}
+```
+
+### Tailwind CSS Integration
+
+The component works seamlessly with Tailwind's design system:
+
+```html
+<!-- Using Tailwind utility classes alongside the component -->
+<ui-label
+  [type]="Labeltype.Tag"
+  [priority]="LabelPriority.High"
+  class="rounded-full px-3 py-1 text-xs font-semibold">
+  Featured
+</ui-label>
+```
+
+## Testing
+
+The library uses **Vitest** with **Angular Testing Utilities** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test label --skip-nx-cache
+
+# Run tests with coverage
+npx nx test label --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test label --watch
+```
+
+### Test Structure
+
+The library includes comprehensive unit tests covering:
+
+- **Type input** - Validates correct CSS class generation for each type
+- **Priority input** - Validates correct CSS class generation for each priority
+- **Default values** - Tests default type and priority behavior
+- **Content projection** - Tests ng-content rendering
+- **Signal reactivity** - Tests computed class updates when inputs change
+- **Class composition** - Tests correct combination of base, type, and priority classes
+
+### Example Test
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { describe, it, expect, beforeEach } from 'vitest';
+import { LabelComponent, Labeltype, LabelPriority } from './label.component';
+
+describe('LabelComponent', () => {
+  let component: LabelComponent;
+  let fixture: ComponentFixture<LabelComponent>;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      imports: [LabelComponent]
+    });
+    fixture = TestBed.createComponent(LabelComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+
+  it('should have default type as Tag', () => {
+    expect(component.type()).toBe(Labeltype.Tag);
+  });
+
+  it('should have default priority as High', () => {
+    expect(component.priority()).toBe(LabelPriority.High);
+  });
+
+  it('should generate correct type class for Tag', () => {
+    fixture.componentRef.setInput('type', Labeltype.Tag);
+    expect(component.typeClass()).toBe('ui-label__tag');
+  });
+
+  it('should generate correct priority class', () => {
+    fixture.componentRef.setInput('type', Labeltype.Tag);
+    fixture.componentRef.setInput('priority', LabelPriority.Medium);
+    expect(component.priorityClass()).toBe('ui-label__tag-priority-medium');
+  });
+
+  it('should apply all classes to host element', () => {
+    fixture.componentRef.setInput('type', Labeltype.Notice);
+    fixture.componentRef.setInput('priority', LabelPriority.Low);
+    fixture.detectChanges();
+
+    const element = fixture.nativeElement as HTMLElement;
+    expect(element.classList.contains('ui-label')).toBe(true);
+    expect(element.classList.contains('ui-label__notice')).toBe(true);
+    expect(element.classList.contains('ui-label__notice-priority-low')).toBe(true);
+  });
+});
+```
+
+## Architecture Notes
+
+### Current Architecture
+
+The library follows Angular standalone component architecture:
+
+```
+LabelComponent (Standalone)
+├── Signal Inputs
+│   ├── type: Signal<Labeltype>
+│   └── priority: Signal<LabelPriority>
+├── Computed Signals
+│   ├── typeClass(): string
+│   └── priorityClass(): string
+└── Host Binding
+    └── [class]: computed classes array
+```
+
+### Design Decisions
+
+#### 1. Standalone Component Architecture
+
+**Decision**: Use standalone component instead of NgModule
+**Rationale**:
+- Aligns with Angular 20.1.2 best practices
+- Reduces boilerplate and complexity
+- Improves tree-shaking and bundle optimization
+- Enables explicit, localized imports
+
+**Impact**: Simpler consumption in feature modules
+
+#### 2. Signal-Based Reactivity
+
+**Decision**: Use `input()` and `computed()` signals instead of traditional inputs
+**Rationale**:
+- Modern Angular reactivity model
+- Automatic dependency tracking
+- Better performance with change detection
+- Type-safe reactive transformations
+
+**Impact**: Efficient CSS class updates without manual change detection
+
+#### 3. ViewEncapsulation.None
+
+**Decision**: Use ViewEncapsulation.None instead of Emulated or ShadowDOM
+**Rationale**:
+- Enables global styling through BEM-like class naming
+- Consistent with ISA design system approach
+- Easier integration with Tailwind CSS
+- Flexible theming capabilities
+
+**Impact**: Requires careful CSS class naming to avoid conflicts
+
+#### 4. OnPush Change Detection
+
+**Decision**: Use OnPush change detection strategy
+**Rationale**:
+- Optimal performance with signal-based inputs
+- Reduces unnecessary change detection cycles
+- Signals automatically trigger required updates
+- Best practice for presentational components
+
+**Impact**: Better performance, especially in large lists
+
+#### 5. TypeScript Const Assertions for Enums
+
+**Decision**: Use const objects with type inference instead of traditional enums
+**Rationale**:
+- Better type safety with literal types
+- Improved autocomplete in IDEs
+- Smaller JavaScript bundle size
+- More flexible than traditional TypeScript enums
+
+**Impact**: Type-safe API with minimal runtime overhead
+
+### Performance Considerations
+
+1. **Signal-based inputs** - Only recompute classes when inputs actually change
+2. **OnPush change detection** - Minimal change detection overhead
+3. **Computed signals** - Efficient memoization of class strings
+4. **No template logic** - All computation in component class
+5. **Lightweight DOM** - Simple ng-content projection with no wrapper elements
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Icon Support** - Add optional icon input for visual enhancement
+2. **Dismissible Labels** - Add optional close button with output event
+3. **Animation Support** - Add entry/exit animations for dynamic labels
+4. **Theme Variants** - Support custom color themes via injection tokens
+5. **Size Variants** - Add size input (small, medium, large)
+6. **Accessibility Improvements** - Add ARIA attributes for screen readers
+7. **Tooltip Integration** - Built-in tooltip support for truncated content
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework (20.1.2)
+- `@angular/common` - CommonModule for basic directives
+
+### Optional Libraries
+
+None - this is a pure presentation component with no external dependencies.
+
+### Path Alias
+
+Import from: `@isa/ui/label`
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/ui/menu/README.md b/libs/ui/menu/README.md
index ac703295a..e2a864c8c 100644
--- a/libs/ui/menu/README.md
+++ b/libs/ui/menu/README.md
@@ -1,7 +1,786 @@
-# ui-menu
+# @isa/ui/menu
 
-This library was generated with [Nx](https://nx.dev).
+A lightweight Angular component library providing accessible menu components built on Angular CDK Menu. Part of the ISA Design System.
 
-## Running unit tests
+## Overview
 
-Run `nx test ui-menu` to execute the unit tests.
+The Menu component library delivers reusable, accessible menu components that wrap Angular CDK Menu directives with ISA-specific styling and conventions. It provides a simple API for creating dropdown menus, context menus, and other menu-based UI patterns.
+
+### Key Features
+
+- **Angular CDK Integration**: Built on `@angular/cdk/menu` for robust accessibility and keyboard navigation
+- **Host Directives Pattern**: Leverages Angular host directives for clean, declarative API
+- **Minimal Overhead**: Thin wrapper around CDK with ISA styling hooks
+- **CSS-Based Styling**: Uses Tailwind and ISA design tokens via CSS classes
+- **Keyboard Navigation**: Full keyboard support (Arrow keys, Enter, Escape) via CDK
+- **ARIA Compliance**: Automatic ARIA attributes for screen readers
+- **Standalone Components**: Modern Angular standalone architecture
+
+## Installation
+
+This library is part of the ISA monorepo and uses path aliases for imports:
+
+```typescript
+import { UiMenu, MenuComponent, MenuItemDirective } from '@isa/ui/menu';
+```
+
+## Quick Start
+
+### Basic Usage
+
+```typescript
+import { Component } from '@angular/core';
+import { UiMenu } from '@isa/ui/menu';
+
+@Component({
+  selector: 'app-example',
+  standalone: true,
+  imports: [UiMenu],
+  template: `
+    <ui-menu>
+      <button uiMenuItem>Action 1</button>
+      <button uiMenuItem>Action 2</button>
+      <button uiMenuItem>Action 3</button>
+    </ui-menu>
+  `
+})
+export class ExampleComponent {}
+```
+
+### Dropdown Menu Example
+
+```typescript
+import { Component } from '@angular/core';
+import { UiMenu } from '@isa/ui/menu';
+import { CdkMenuTrigger } from '@angular/cdk/menu';
+
+@Component({
+  selector: 'app-dropdown-example',
+  standalone: true,
+  imports: [UiMenu, CdkMenuTrigger],
+  template: `
+    <button [cdkMenuTriggerFor]="menu">Open Menu</button>
+
+    <ng-template #menu>
+      <ui-menu>
+        <button uiMenuItem (click)="onEdit()">Edit</button>
+        <button uiMenuItem (click)="onDelete()">Delete</button>
+        <button uiMenuItem (click)="onShare()">Share</button>
+      </ui-menu>
+    </ng-template>
+  `
+})
+export class DropdownExampleComponent {
+  onEdit() { console.log('Edit clicked'); }
+  onDelete() { console.log('Delete clicked'); }
+  onShare() { console.log('Share clicked'); }
+}
+```
+
+## API Reference
+
+### MenuComponent
+
+**Selector**: `ui-menu`
+
+A container component for menu items that provides accessibility and keyboard navigation.
+
+#### Host Directives
+
+- **CdkMenu**: Provides core menu functionality, keyboard navigation, and ARIA attributes
+
+#### Host Properties
+
+- **CSS Class**: `.ui-menu` - Applied to the host element for styling
+
+#### Template
+
+- Simple content projection: `<ng-content></ng-content>`
+
+####Configuration
+
+- **Change Detection**: Default (inherited from Angular)
+- **View Encapsulation**: Default
+- **Standalone**: `false` (import via `UiMenu` array)
+
+### MenuItemDirective
+
+**Selector**: `[uiMenuItem]`
+
+A directive that marks elements as menu items, adding appropriate styling and behavior.
+
+#### Host Directives
+
+- **CdkMenuItem**: Provides menu item functionality, click handling, and ARIA attributes
+
+#### Host Properties
+
+- **CSS Class**: `.ui-menu-item` - Applied to the host element for styling
+
+#### Configuration
+
+- **Standalone**: `false` (import via `UiMenu` array)
+
+### UiMenu Import Array
+
+Convenience import for both menu components:
+
+```typescript
+export const UiMenu = [MenuComponent, MenuItemDirective];
+```
+
+**Usage**:
+```typescript
+imports: [UiMenu]  // Imports both MenuComponent and MenuItemDirective
+```
+
+## Usage Examples
+
+### Example 1: Simple Menu List
+
+```typescript
+import { Component } from '@angular/core';
+import { UiMenu } from '@isa/ui/menu';
+
+@Component({
+  selector: 'app-simple-menu',
+  standalone: true,
+  imports: [UiMenu],
+  template: `
+    <ui-menu>
+      <button uiMenuItem>Home</button>
+      <button uiMenuItem>About</button>
+      <button uiMenuItem>Contact</button>
+    </ui-menu>
+  `
+})
+export class SimpleMenuComponent {}
+```
+
+### Example 2: Context Menu with Icons
+
+```typescript
+import { Component } from '@angular/core';
+import { UiMenu } from '@isa/ui/menu';
+import { CdkContextMenuTrigger } from '@angular/cdk/menu';
+import { NgIconComponent } from '@ng-icons/core';
+
+@Component({
+  selector: 'app-context-menu',
+  standalone: true,
+  imports: [UiMenu, CdkContextMenuTrigger, NgIconComponent],
+  template: `
+    <div [cdkContextMenuTriggerFor]="contextMenu" class="context-area">
+      Right-click here
+    </div>
+
+    <ng-template #contextMenu>
+      <ui-menu>
+        <button uiMenuItem>
+          <ng-icon name="isaActionCopy"></ng-icon>
+          Copy
+        </button>
+        <button uiMenuItem>
+          <ng-icon name="isaActionPaste"></ng-icon>
+          Paste
+        </button>
+        <button uiMenuItem>
+          <ng-icon name="isaActionDelete"></ng-icon>
+          Delete
+        </button>
+      </ui-menu>
+    </ng-template>
+  `
+})
+export class ContextMenuComponent {}
+```
+
+### Example 3: Nested Menus (Submenus)
+
+```typescript
+import { Component } from '@angular/core';
+import { UiMenu } from '@isa/ui/menu';
+import { CdkMenuTrigger } from '@angular/cdk/menu';
+
+@Component({
+  selector: 'app-nested-menu',
+  standalone: true,
+  imports: [UiMenu, CdkMenuTrigger],
+  template: `
+    <button [cdkMenuTriggerFor]="mainMenu">File</button>
+
+    <ng-template #mainMenu>
+      <ui-menu>
+        <button uiMenuItem>New File</button>
+        <button uiMenuItem [cdkMenuTriggerFor]="openMenu">Open</button>
+        <button uiMenuItem>Save</button>
+      </ui-menu>
+    </ng-template>
+
+    <ng-template #openMenu>
+      <ui-menu>
+        <button uiMenuItem>Recent Files</button>
+        <button uiMenuItem>Browse...</button>
+      </ui-menu>
+    </ng-template>
+  `
+})
+export class NestedMenuComponent {}
+```
+
+### Example 4: Menu with Disabled Items
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { UiMenu } from '@isa/ui/menu';
+import { CdkMenuTrigger } from '@angular/cdk/menu';
+
+@Component({
+  selector: 'app-disabled-menu',
+  standalone: true,
+  imports: [UiMenu, CdkMenuTrigger],
+  template: `
+    <button [cdkMenuTriggerFor]="menu">Actions</button>
+
+    <ng-template #menu>
+      <ui-menu>
+        <button uiMenuItem [disabled]="false">Edit</button>
+        <button uiMenuItem [disabled]="!canDelete()">Delete</button>
+        <button uiMenuItem [disabled]="false">Share</button>
+      </ui-menu>
+    </ng-template>
+  `
+})
+export class DisabledMenuComponent {
+  canDelete = signal(false);  // Dynamic disabled state
+}
+```
+
+### Example 5: Menu with Click Handlers
+
+```typescript
+import { Component } from '@angular/core';
+import { UiMenu } from '@isa/ui/menu';
+import { CdkMenuTrigger } from '@angular/cdk/menu';
+import { Router } from '@angular/router';
+
+@Component({
+  selector: 'app-navigation-menu',
+  standalone: true,
+  imports: [UiMenu, CdkMenuTrigger],
+  template: `
+    <button [cdkMenuTriggerFor]="menu">Navigate</button>
+
+    <ng-template #menu>
+      <ui-menu>
+        <button uiMenuItem (click)="navigateTo('/dashboard')">Dashboard</button>
+        <button uiMenuItem (click)="navigateTo('/reports')">Reports</button>
+        <button uiMenuItem (click)="navigateTo('/settings')">Settings</button>
+        <button uiMenuItem (click)="logout()">Logout</button>
+      </ui-menu>
+    </ng-template>
+  `
+})
+export class NavigationMenuComponent {
+  constructor(private router: Router) {}
+
+  navigateTo(path: string): void {
+    this.router.navigate([path]);
+  }
+
+  logout(): void {
+    // Logout logic
+  }
+}
+```
+
+## Architecture Notes
+
+### Component Structure
+
+```
+MenuComponent
+├── Host Element (<ui-menu>)
+│   ├── Host Directive: CdkMenu
+│   │   ├── Keyboard Navigation (Arrow keys, Enter, Escape)
+│   │   ├── ARIA Attributes (role="menu")
+│   │   └── Focus Management
+│   ├── CSS Class: .ui-menu
+│   └── <ng-content> (Projects menu items)
+
+MenuItemDirective
+├── Host Element ([uiMenuItem])
+│   ├── Host Directive: CdkMenuItem
+│   │   ├── Click Handling
+│   │   ├── ARIA Attributes (role="menuitem")
+│   │   └── Keyboard Interaction
+│   └── CSS Class: .ui-menu-item
+```
+
+### Host Directives Pattern
+
+**Why Host Directives?**
+
+This library uses Angular's **host directives** feature introduced in Angular 15 to:
+
+1. **Reuse CDK Logic**: Leverage `@angular/cdk/menu` without re-implementing functionality
+2. **Clean API**: Hide CDK complexity while exposing ISA-specific styling
+3. **Maintainability**: CDK updates automatically benefit this library
+4. **Type Safety**: Full TypeScript support for all CDK features
+
+**How It Works**:
+
+```typescript
+@Component({
+  selector: 'ui-menu',
+  template: '<ng-content></ng-content>',
+  host: { class: 'ui-menu' },
+  hostDirectives: [CdkMenu],  // Applies CdkMenu to this component's host
+})
+export class MenuComponent {}
+```
+
+When you use `<ui-menu>`, it automatically:
+- Applies all `CdkMenu` behaviors (keyboard nav, ARIA, etc.)
+- Adds `.ui-menu` CSS class for styling
+- Projects child content (menu items)
+
+### CDK Menu Features
+
+**Automatic Features** (via CdkMenu):
+
+- **Keyboard Navigation**:
+  - `↓` / `↑`: Navigate menu items
+  - `Enter` / `Space`: Activate item
+  - `Escape`: Close menu
+  - `Tab`: Move focus out of menu
+
+- **ARIA Attributes**:
+  - `role="menu"` on menu container
+  - `role="menuitem"` on menu items
+  - `aria-disabled` on disabled items
+  - `aria-haspopup` for submenus
+
+- **Focus Management**:
+  - Auto-focus first item on open
+  - Circular focus wrapping
+  - Focus restoration on close
+
+### Styling Architecture
+
+**CSS Class Hooks**:
+
+```scss
+// Applied by MenuComponent
+.ui-menu {
+  // Container styles (padding, background, border, shadow)
+}
+
+// Applied by MenuItemDirective
+.ui-menu-item {
+  // Item styles (padding, hover, focus, active states)
+}
+
+// Disabled state (via CDK)
+.ui-menu-item[disabled] {
+  // Disabled styles (opacity, cursor, pointer-events)
+}
+```
+
+**Tailwind Integration**:
+
+The library provides CSS class hooks that can be styled via:
+- Global SCSS files
+- Tailwind `@apply` directives
+- Custom Tailwind plugins (ISA menu plugin)
+
+**Example Tailwind Configuration**:
+
+```css
+/* styles.scss */
+.ui-menu {
+  @apply bg-white shadow-lg rounded-md py-1;
+}
+
+.ui-menu-item {
+  @apply px-4 py-2 hover:bg-gray-100 cursor-pointer;
+}
+
+.ui-menu-item[disabled] {
+  @apply opacity-50 cursor-not-allowed;
+}
+```
+
+### Integration with Angular CDK
+
+**Required CDK Directives** (imported separately):
+
+```typescript
+import { CdkMenuTrigger } from '@angular/cdk/menu';  // For dropdown triggers
+import { CdkContextMenuTrigger } from '@angular/cdk/menu';  // For context menus
+```
+
+**CDK Menu Trigger**:
+
+```typescript
+<button [cdkMenuTriggerFor]="menuTemplate">Open Menu</button>
+<ng-template #menuTemplate>
+  <ui-menu>...</ui-menu>
+</ng-template>
+```
+
+**CDK Context Menu Trigger**:
+
+```typescript
+<div [cdkContextMenuTriggerFor]="contextMenuTemplate">Right-click me</div>
+<ng-template #contextMenuTemplate>
+  <ui-menu>...</ui-menu>
+</ng-template>
+```
+
+### Performance Characteristics
+
+**Optimization Strategies**:
+- **Lightweight Components**: Minimal overhead over CDK base
+- **No Template**: MenuComponent uses empty template (content projection only)
+- **No Change Detection**: Default strategy (components are simple wrappers)
+- **CDK Optimizations**: Inherits CDK's efficient event handling and focus management
+
+**Bundle Impact**:
+- **Component Size**: ~2KB (both components combined)
+- **CDK Dependency**: ~15KB (shared with other CDK features)
+- **Total Overhead**: Minimal, mostly CDK dependency
+
+## Dependencies
+
+### Angular Dependencies
+
+| Package | Version | Purpose |
+|---------|---------|---------|
+| `@angular/core` | 20.1.2 | Component framework and dependency injection |
+| `@angular/cdk/menu` | 20.1.2 | CDK Menu directives for accessibility and keyboard nav |
+
+### Internal Dependencies
+
+None - this library has no dependencies on other `@isa/*` libraries.
+
+### Peer Dependencies
+
+```json
+{
+  "peerDependencies": {
+    "@angular/core": "^20.0.0",
+    "@angular/cdk": "^20.0.0"
+  }
+}
+```
+
+## Testing
+
+### Test Configuration
+
+**Framework**: Jest
+
+**Configuration**: `jest.config.ts` (extends workspace defaults)
+
+### Running Tests
+
+```bash
+# Run tests with fresh results
+npx nx test ui-menu --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test ui-menu --watch
+
+# Run tests with coverage
+npx nx test ui-menu --code-coverage --skip-nx-cache
+```
+
+### Testing Recommendations
+
+#### Unit Test Coverage
+
+**Test menu rendering**:
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { MenuComponent, MenuItemDirective } from '@isa/ui/menu';
+
+describe('MenuComponent', () => {
+  it('should render menu with items', () => {
+    const fixture = TestBed.createComponent(MenuComponent);
+    fixture.detectChanges();
+
+    const menuElement = fixture.nativeElement;
+    expect(menuElement.classList.contains('ui-menu')).toBe(true);
+  });
+});
+```
+
+**Test menu item directive**:
+```typescript
+describe('MenuItemDirective', () => {
+  it('should apply ui-menu-item class', () => {
+    // Create test component with directive
+    const fixture = TestBed.createComponent(TestHostComponent);
+    fixture.detectChanges();
+
+    const menuItem = fixture.nativeElement.querySelector('[uiMenuItem]');
+    expect(menuItem.classList.contains('ui-menu-item')).toBe(true);
+  });
+});
+```
+
+**Test keyboard navigation** (via CDK):
+```typescript
+it('should navigate menu items with keyboard', () => {
+  const fixture = TestBed.createComponent(MenuComponent);
+  fixture.detectChanges();
+
+  const menuElement = fixture.nativeElement;
+
+  // Simulate down arrow
+  menuElement.dispatchEvent(new KeyboardEvent('keydown', { key: 'ArrowDown' }));
+
+  // Verify focus moved
+  expect(document.activeElement).toBe(firstMenuItem);
+});
+```
+
+#### Integration Test Scenarios
+
+**Test with CDK trigger**:
+```typescript
+import { CdkMenuTrigger } from '@angular/cdk/menu';
+
+@Component({
+  template: `
+    <button [cdkMenuTriggerFor]="menu" #trigger="cdkMenuTrigger">Open</button>
+    <ng-template #menu>
+      <ui-menu>
+        <button uiMenuItem>Item 1</button>
+      </ui-menu>
+    </ng-template>
+  `
+})
+class TestHostComponent {}
+
+it('should open menu on trigger click', () => {
+  const fixture = TestBed.createComponent(TestHostComponent);
+  fixture.detectChanges();
+
+  const triggerButton = fixture.nativeElement.querySelector('button');
+  triggerButton.click();
+  fixture.detectChanges();
+
+  // Verify menu is open
+  const menu = document.querySelector('ui-menu');
+  expect(menu).toBeTruthy();
+});
+```
+
+## Best Practices
+
+### 1. Use CDK Triggers for Dropdown Menus
+
+```typescript
+// ✅ GOOD: Use CdkMenuTrigger for dropdowns
+<button [cdkMenuTriggerFor]="menu">Open Menu</button>
+<ng-template #menu>
+  <ui-menu>...</ui-menu>
+</ng-template>
+
+// ❌ BAD: Manual show/hide logic
+<button (click)="showMenu = true">Open Menu</button>
+<ui-menu *ngIf="showMenu">...</ui-menu>
+```
+
+### 2. Always Use MenuItemDirective on Interactive Elements
+
+```typescript
+// ✅ GOOD: Apply directive to buttons
+<ui-menu>
+  <button uiMenuItem>Action</button>
+</ui-menu>
+
+// ❌ BAD: Non-interactive elements
+<ui-menu>
+  <div uiMenuItem>Action</div>  // Won't receive keyboard events properly
+</ui-menu>
+```
+
+### 3. Leverage CDK Features
+
+```typescript
+// ✅ GOOD: Use CDK for submenus
+<button uiMenuItem [cdkMenuTriggerFor]="submenu">More</button>
+<ng-template #submenu>
+  <ui-menu>...</ui-menu>
+</ng-template>
+
+// ❌ BAD: Manual submenu implementation
+<button uiMenuItem (click)="toggleSubmenu()">More</button>
+<ui-menu *ngIf="submenuOpen">...</ui-menu>
+```
+
+### 4. Provide ARIA Labels for Icon-Only Items
+
+```typescript
+// ✅ GOOD: Accessible icon-only menu item
+<button uiMenuItem aria-label="Delete">
+  <ng-icon name="isaActionDelete"></ng-icon>
+</button>
+
+// ❌ BAD: No accessible label
+<button uiMenuItem>
+  <ng-icon name="isaActionDelete"></ng-icon>
+</button>
+```
+
+### 5. Use Semantic HTML
+
+```typescript
+// ✅ GOOD: Use buttons for actions
+<ui-menu>
+  <button uiMenuItem>Edit</button>
+  <button uiMenuItem>Delete</button>
+</ui-menu>
+
+// ❌ BAD: Use divs/spans
+<ui-menu>
+  <div uiMenuItem>Edit</div>
+  <span uiMenuItem>Delete</span>
+</ui-menu>
+```
+
+### 6. Handle Menu Item Clicks Properly
+
+```typescript
+// ✅ GOOD: Use click handlers on menu items
+<button uiMenuItem (click)="handleAction()">Action</button>
+
+// ❌ BAD: Wrap in extra divs with click handlers
+<div (click)="handleAction()">
+  <button uiMenuItem>Action</button>
+</div>
+```
+
+## Common Pitfalls
+
+### 1. Forgetting CDK Imports
+
+```typescript
+// ❌ ERROR: Missing CdkMenuTrigger import
+imports: [UiMenu]
+
+// ✅ CORRECT: Import CDK directives separately
+imports: [UiMenu, CdkMenuTrigger]
+```
+
+### 2. Using Menu Without Template
+
+```typescript
+// ❌ ERROR: Menu needs ng-template with trigger
+<ui-menu>
+  <button uiMenuItem>Item</button>
+</ui-menu>
+
+// ✅ CORRECT: Use with CDK trigger and template
+<button [cdkMenuTriggerFor]="menu">Open</button>
+<ng-template #menu>
+  <ui-menu>
+    <button uiMenuItem>Item</button>
+  </ui-menu>
+</ng-template>
+```
+
+### 3. Incorrect Selector Usage
+
+```typescript
+// ❌ ERROR: Wrong directive name
+<button menuItem>Action</button>
+
+// ✅ CORRECT: Use uiMenuItem
+<button uiMenuItem>Action</button>
+```
+
+## Migration Guide
+
+### From Custom Menu to @isa/ui/menu
+
+**Before**:
+```typescript
+@Component({
+  template: `
+    <div class="custom-menu">
+      <div class="menu-item" (click)="action1()">Action 1</div>
+      <div class="menu-item" (click)="action2()">Action 2</div>
+    </div>
+  `
+})
+```
+
+**After**:
+```typescript
+import { UiMenu } from '@isa/ui/menu';
+import { CdkMenuTrigger } from '@angular/cdk/menu';
+
+@Component({
+  standalone: true,
+  imports: [UiMenu, CdkMenuTrigger],
+  template: `
+    <button [cdkMenuTriggerFor]="menu">Open Menu</button>
+    <ng-template #menu>
+      <ui-menu>
+        <button uiMenuItem (click)="action1()">Action 1</button>
+        <button uiMenuItem (click)="action2()">Action 2</button>
+      </ui-menu>
+    </ng-template>
+  `
+})
+```
+
+**Benefits**:
+- Automatic keyboard navigation
+- ARIA compliance
+- Focus management
+- Consistent styling
+- Less custom code
+
+## Related Documentation
+
+- **Angular CDK Menu**: [Official CDK Menu Documentation](https://material.angular.io/cdk/menu/overview)
+- **Host Directives**: Angular guide on host directives
+- **@isa/ui/buttons**: Button components often used with menus
+- **ISA Design System**: Menu styling guidelines
+
+## Support and Contributing
+
+For questions, issues, or contributions related to the Menu components:
+
+1. Review Angular CDK Menu documentation for advanced features
+2. Check ISA Design System for styling standards
+3. Consult Tailwind configuration for menu styling utilities
+4. Follow Angular standalone component best practices
+
+## Changelog
+
+### Current Version
+
+**Features**:
+- Standalone-ready component and directive
+- Angular CDK Menu integration via host directives
+- Minimal API surface (component + directive)
+- Full keyboard navigation and ARIA support
+- Tailwind/ISA design system styling hooks
+
+**Testing**:
+- Jest configuration
+- Unit tests for component and directive
+
+---
+
+**Package**: `@isa/ui/menu`
+**Path Alias**: `@isa/ui/menu`
+**Entry Point**: `libs/ui/menu/src/index.ts`
+**Selectors**: `ui-menu`, `[uiMenuItem]`
+**Type**: Angular Component Library (CDK Wrapper)
diff --git a/libs/ui/progress-bar/README.md b/libs/ui/progress-bar/README.md
index cc585b39c..e78b1962a 100644
--- a/libs/ui/progress-bar/README.md
+++ b/libs/ui/progress-bar/README.md
@@ -1,7 +1,512 @@
-# ui-progress-bar
+# @isa/ui/progress-bar
 
-This library was generated with [Nx](https://nx.dev).
+A lightweight Angular progress bar component supporting both determinate and indeterminate modes.
 
-## Running unit tests
+## Overview
 
-Run `nx test ui-progress-bar` to execute the unit tests.
+The Progress Bar library provides a simple, performant component for visualizing progress or loading states. It supports two modes: determinate (with specific progress value) and indeterminate (continuous loading animation), making it suitable for various use cases from file uploads to background processing indicators.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Styling and Customization](#styling-and-customization)
+- [Testing](#testing)
+- [Dependencies](#dependencies)
+
+## Features
+
+- **Two display modes** - Determinate (percentage-based) and indeterminate (continuous animation)
+- **Customizable progress** - Configurable value and max value for flexible percentage calculations
+- **Standalone component** - Fully standalone, no module imports required
+- **Signal-based inputs** - Reactive updates using Angular signals
+- **Computed width** - Automatically calculates bar width based on value/maxValue ratio
+- **OnPush change detection** - Optimized for performance
+- **ViewEncapsulation.None** - Allows global styling customization
+
+## Quick Start
+
+### 1. Import the Component
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { ProgressBarComponent, ProgressBarMode } from '@isa/ui/progress-bar';
+
+@Component({
+  selector: 'app-upload',
+  standalone: true,
+  imports: [ProgressBarComponent],
+  template: '...'
+})
+export class UploadComponent {
+  uploadProgress = signal(0);
+}
+```
+
+### 2. Determinate Mode (Default)
+
+```html
+<!-- Show specific progress percentage -->
+<ui-progress-bar
+  [value]="uploadProgress()"
+  [maxValue]="100"
+></ui-progress-bar>
+```
+
+### 3. Indeterminate Mode
+
+```html
+<!-- Show continuous loading animation -->
+<ui-progress-bar
+  [mode]="'indeterminate'"
+></ui-progress-bar>
+```
+
+### 4. Custom Value Range
+
+```html
+<!-- Progress out of custom max value -->
+<ui-progress-bar
+  [value]="processedItems()"
+  [maxValue]="totalItems()"
+></ui-progress-bar>
+```
+
+## API Reference
+
+### ProgressBarComponent
+
+Standalone component that displays a visual progress indicator.
+
+**Selector:** `ui-progress-bar`
+
+#### Inputs
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `mode` | `ProgressBarMode` | `'determinate'` | Display mode: `'determinate'` or `'indeterminate'` |
+| `value` | `number` | `50` | Current progress value (used in determinate mode) |
+| `maxValue` | `number` | `100` | Maximum value for percentage calculation |
+
+#### ProgressBarMode Type
+
+```typescript
+export const ProgressBarMode = {
+  Determinate: 'determinate',     // Percentage-based progress
+  Indeterminate: 'indeterminate'  // Continuous loading animation
+} as const;
+
+export type ProgressBarMode =
+  (typeof ProgressBarMode)[keyof typeof ProgressBarMode];
+```
+
+#### Computed Properties
+
+##### `modeClass(): string`
+
+Returns the CSS class for the current mode:
+- `'ui-progress-bar__determinate'` - For determinate mode
+- `'ui-progress-bar__indeterminate'` - For indeterminate mode
+
+##### `width(): string`
+
+Calculates the progress bar width:
+- **Indeterminate mode**: Returns `'100%'`
+- **Determinate mode**: Returns `(value / maxValue * 100)%`
+
+#### Host Classes
+
+- `ui-progress-bar` - Always applied
+- `ui-progress-bar__determinate` or `ui-progress-bar__indeterminate` - Based on mode
+
+#### Template Structure
+
+```html
+<div class="ui-progress-bar__bar" [style.width]="width()"></div>
+```
+
+## Usage Examples
+
+### File Upload Progress
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { ProgressBarComponent } from '@isa/ui/progress-bar';
+
+@Component({
+  selector: 'app-file-upload',
+  standalone: true,
+  imports: [ProgressBarComponent],
+  template: `
+    <div class="upload-container">
+      <h3>Uploading {{ fileName() }}</h3>
+
+      <ui-progress-bar
+        [value]="uploadProgress()"
+        [maxValue]="100"
+        data-what="upload-progress-bar"
+      ></ui-progress-bar>
+
+      <p>{{ uploadProgress() }}% complete</p>
+    </div>
+  `
+})
+export class FileUploadComponent {
+  fileName = signal('document.pdf');
+  uploadProgress = signal(0);
+
+  async uploadFile(file: File): Promise<void> {
+    this.fileName.set(file.name);
+    this.uploadProgress.set(0);
+
+    // Simulate upload progress
+    const interval = setInterval(() => {
+      this.uploadProgress.update(p => {
+        if (p >= 100) {
+          clearInterval(interval);
+          return 100;
+        }
+        return p + 10;
+      });
+    }, 500);
+  }
+}
+```
+
+### Loading Indicator
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { ProgressBarComponent, ProgressBarMode } from '@isa/ui/progress-bar';
+
+@Component({
+  selector: 'app-data-loader',
+  standalone: true,
+  imports: [ProgressBarComponent],
+  template: `
+    @if (isLoading()) {
+      <ui-progress-bar
+        [mode]="'indeterminate'"
+        data-what="loading-indicator"
+      ></ui-progress-bar>
+    }
+
+    <div class="content">
+      @for (item of data(); track item.id) {
+        <div>{{ item.name }}</div>
+      }
+    </div>
+  `
+})
+export class DataLoaderComponent {
+  isLoading = signal(true);
+  data = signal<DataItem[]>([]);
+
+  async loadData(): Promise<void> {
+    this.isLoading.set(true);
+    try {
+      const result = await this.dataService.fetch();
+      this.data.set(result);
+    } finally {
+      this.isLoading.set(false);
+    }
+  }
+}
+```
+
+### Batch Processing Progress
+
+```typescript
+import { Component, computed, signal } from '@angular/core';
+import { ProgressBarComponent } from '@isa/ui/progress-bar';
+
+@Component({
+  selector: 'app-batch-processor',
+  standalone: true,
+  imports: [ProgressBarComponent],
+  template: `
+    <div class="batch-progress">
+      <h3>Processing Items</h3>
+
+      <ui-progress-bar
+        [value]="processedCount()"
+        [maxValue]="totalCount()"
+      ></ui-progress-bar>
+
+      <p>
+        {{ processedCount() }} of {{ totalCount() }} items processed
+        ({{ percentComplete() }}%)
+      </p>
+    </div>
+  `
+})
+export class BatchProcessorComponent {
+  processedCount = signal(0);
+  totalCount = signal(100);
+
+  percentComplete = computed(() => {
+    const total = this.totalCount();
+    if (total === 0) return 0;
+    return Math.round((this.processedCount() / total) * 100);
+  });
+
+  async processItems(items: Item[]): Promise<void> {
+    this.totalCount.set(items.length);
+    this.processedCount.set(0);
+
+    for (const item of items) {
+      await this.processItem(item);
+      this.processedCount.update(c => c + 1);
+    }
+  }
+}
+```
+
+### Multi-Step Progress
+
+```typescript
+import { Component, computed, signal } from '@angular/core';
+import { ProgressBarComponent } from '@isa/ui/progress-bar';
+
+@Component({
+  selector: 'app-wizard',
+  standalone: true,
+  imports: [ProgressBarComponent],
+  template: `
+    <div class="wizard">
+      <ui-progress-bar
+        [value]="currentStep()"
+        [maxValue]="totalSteps()"
+      ></ui-progress-bar>
+
+      <div class="step-indicator">
+        Step {{ currentStep() }} of {{ totalSteps() }}
+      </div>
+
+      <div class="step-content">
+        @switch (currentStep()) {
+          @case (1) {
+            <div>Step 1: Basic Information</div>
+          }
+          @case (2) {
+            <div>Step 2: Address Details</div>
+          }
+          @case (3) {
+            <div>Step 3: Payment Method</div>
+          }
+          @case (4) {
+            <div>Step 4: Review & Confirm</div>
+          }
+        }
+      </div>
+
+      <div class="actions">
+        <button
+          [disabled]="currentStep() === 1"
+          (click)="previousStep()"
+        >
+          Previous
+        </button>
+        <button
+          [disabled]="currentStep() === totalSteps()"
+          (click)="nextStep()"
+        >
+          Next
+        </button>
+      </div>
+    </div>
+  `
+})
+export class WizardComponent {
+  currentStep = signal(1);
+  totalSteps = signal(4);
+
+  nextStep(): void {
+    this.currentStep.update(s => Math.min(s + 1, this.totalSteps()));
+  }
+
+  previousStep(): void {
+    this.currentStep.update(s => Math.max(s - 1, 1));
+  }
+}
+```
+
+## Styling and Customization
+
+### Default Classes
+
+```html
+<!-- Determinate mode -->
+<ui-progress-bar class="ui-progress-bar ui-progress-bar__determinate">
+  <div class="ui-progress-bar__bar" style="width: 50%;"></div>
+</ui-progress-bar>
+
+<!-- Indeterminate mode -->
+<ui-progress-bar class="ui-progress-bar ui-progress-bar__indeterminate">
+  <div class="ui-progress-bar__bar" style="width: 100%;"></div>
+</ui-progress-bar>
+```
+
+### Custom Styling
+
+```scss
+// Base progress bar container
+.ui-progress-bar {
+  width: 100%;
+  height: 4px;
+  background-color: #e0e0e0;
+  border-radius: 2px;
+  overflow: hidden;
+}
+
+// The moving/filling bar
+.ui-progress-bar__bar {
+  height: 100%;
+  background-color: #2196f3;
+  transition: width 0.3s ease-in-out;
+}
+
+// Determinate mode specific styles
+.ui-progress-bar__determinate .ui-progress-bar__bar {
+  background: linear-gradient(90deg, #1976d2 0%, #2196f3 100%);
+}
+
+// Indeterminate mode animation
+.ui-progress-bar__indeterminate .ui-progress-bar__bar {
+  animation: indeterminate-progress 2s linear infinite;
+  background: linear-gradient(
+    90deg,
+    transparent 0%,
+    #2196f3 50%,
+    transparent 100%
+  );
+}
+
+@keyframes indeterminate-progress {
+  0% {
+    transform: translateX(-100%);
+  }
+  100% {
+    transform: translateX(100%);
+  }
+}
+
+// Color variants
+.ui-progress-bar--success .ui-progress-bar__bar {
+  background-color: #4caf50;
+}
+
+.ui-progress-bar--warning .ui-progress-bar__bar {
+  background-color: #ff9800;
+}
+
+.ui-progress-bar--error .ui-progress-bar__bar {
+  background-color: #f44336;
+}
+```
+
+## Testing
+
+The library uses **Jest** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for progress-bar
+npx nx test ui-progress-bar --skip-nx-cache
+
+# Run tests with coverage
+npx nx test ui-progress-bar --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test ui-progress-bar --watch
+```
+
+### Test Coverage
+
+Tests should cover:
+
+- **Mode switching** - Determinate and indeterminate modes
+- **Width calculation** - Correct percentage calculation from value/maxValue
+- **Boundary conditions** - 0%, 100%, values exceeding maxValue
+- **Signal reactivity** - Updates when value/maxValue change
+- **Class application** - Correct mode classes applied
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework (v20.1.2)
+
+### Path Alias
+
+Import from: `@isa/ui/progress-bar`
+
+### Peer Dependencies
+
+- Angular 20.1.2 or higher
+- TypeScript 5.8.3 or higher
+
+## Best Practices
+
+### 1. Use Appropriate Mode
+
+Choose the mode based on whether progress is measurable:
+
+```html
+<!-- Measurable progress - use determinate -->
+<ui-progress-bar [value]="uploadedBytes" [maxValue]="totalBytes"></ui-progress-bar>
+
+<!-- Unknown duration - use indeterminate -->
+<ui-progress-bar [mode]="'indeterminate'"></ui-progress-bar>
+```
+
+### 2. Provide Context
+
+Always accompany the progress bar with text:
+
+```html
+<div class="progress-container">
+  <label>Uploading...</label>
+  <ui-progress-bar [value]="progress" [maxValue]="100"></ui-progress-bar>
+  <span>{{ progress }}%</span>
+</div>
+```
+
+### 3. Handle Edge Cases
+
+Validate values to prevent division by zero or negative percentages:
+
+```typescript
+percentComplete = computed(() => {
+  const max = this.maxValue();
+  const val = this.value();
+
+  if (max === 0) return 0;
+  return Math.min(Math.max((val / max) * 100, 0), 100);
+});
+```
+
+### 4. Smooth Updates
+
+For smoother visual transitions, update progress in reasonable increments:
+
+```typescript
+// Good: Update every 5-10%
+updateProgress(newValue: number) {
+  if (newValue - this.progress() >= 5) {
+    this.progress.set(newValue);
+  }
+}
+
+// Bad: Update every tiny increment
+updateProgress(newValue: number) {
+  this.progress.set(newValue); // Updates too frequently
+}
+```
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/ui/search-bar/README.md b/libs/ui/search-bar/README.md
index 0d49d9197..80c418fe3 100644
--- a/libs/ui/search-bar/README.md
+++ b/libs/ui/search-bar/README.md
@@ -1,7 +1,773 @@
-# ui-search-bar
+# @isa/ui/search-bar
 
-This library was generated with [Nx](https://nx.dev).
+A feature-rich Angular search bar component with integrated clear functionality and customizable appearance modes.
 
-## Running unit tests
+## Overview
 
-Run `nx test ui-search-bar` to execute the unit tests.
+The Search Bar library provides a flexible and accessible search input component designed for the ISA application. It supports two appearance modes (main and results), integrates seamlessly with Angular Forms using `NgControl`, and includes a dedicated clear button component with automatic focus restoration.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Styling and Customization](#styling-and-customization)
+- [Architecture Notes](#architecture-notes)
+- [Testing](#testing)
+- [Dependencies](#dependencies)
+
+## Features
+
+- **Two appearance modes** - Main and results views with distinct styling
+- **Angular Forms integration** - Works with `FormControl` and `NgControl` via content projection
+- **Integrated clear button** - Dedicated component with automatic focus restoration
+- **Icon support** - Prefix and suffix icon slots using `ng-icons`
+- **Signal-based reactivity** - Computed appearance classes for efficient updates
+- **OnPush change detection** - Optimized performance
+- **Accessibility** - Proper focus management and ARIA attributes
+- **Content projection** - Flexible composition with multiple slot patterns
+
+## Quick Start
+
+### 1. Import the Components
+
+```typescript
+import { Component } from '@angular/core';
+import { FormControl, ReactiveFormsModule } from '@angular/forms';
+import { UiSearchBarComponent, UiSearchBarClearComponent } from '@isa/ui/search-bar';
+import { IconButtonComponent } from '@isa/ui/buttons';
+import { NgIconComponent, provideIcons } from '@ng-icons/core';
+import { isaActionSearch } from '@isa/icons';
+
+@Component({
+  selector: 'app-search',
+  standalone: true,
+  imports: [
+    ReactiveFormsModule,
+    UiSearchBarComponent,
+    UiSearchBarClearComponent,
+    IconButtonComponent,
+    NgIconComponent
+  ],
+  providers: [provideIcons({ isaActionSearch })],
+  template: '...'
+})
+export class SearchComponent {
+  searchControl = new FormControl('');
+}
+```
+
+### 2. Basic Usage
+
+```html
+<ui-search-bar>
+  <input
+    type="text"
+    [formControl]="searchControl"
+    placeholder="Search..."
+    data-what="search-input"
+  />
+  <ui-search-bar-clear></ui-search-bar-clear>
+  <ui-icon-button name="isaActionSearch"></ui-icon-button>
+</ui-search-bar>
+```
+
+### 3. With Prefix Icon
+
+```html
+<ui-search-bar appearance="results">
+  <ui-icon-button prefix name="isaActionSearch"></ui-icon-button>
+  <input
+    type="text"
+    [formControl]="searchControl"
+    placeholder="Filter results..."
+  />
+  <ui-search-bar-clear></ui-search-bar-clear>
+</ui-search-bar>
+```
+
+### 4. Custom Reset Value
+
+```html
+<ui-search-bar>
+  <input type="text" [formControl]="searchControl" />
+  <!-- Reset to specific value instead of null -->
+  <ui-search-bar-clear [value]="defaultSearchTerm"></ui-search-bar-clear>
+  <ui-icon-button name="isaActionSearch"></ui-icon-button>
+</ui-search-bar>
+```
+
+## API Reference
+
+### UiSearchBarComponent
+
+Container component that provides structure and styling for search inputs.
+
+**Selector:** `ui-search-bar`
+
+#### Inputs
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `appearance` | `SearchbarAppearance` | `'main'` | Visual appearance mode: `'main'` or `'results'` |
+
+#### SearchbarAppearance Type
+
+```typescript
+export const SearchbarAppearance = {
+  Main: 'main',      // Primary search bar appearance
+  Results: 'results' // Results filtering appearance
+} as const;
+
+export type SearchbarAppearance =
+  (typeof SearchbarAppearance)[keyof typeof SearchbarAppearance];
+```
+
+#### Content Projection Slots
+
+The component uses content projection with specific selectors:
+
+```html
+<!-- Prefix icon slot -->
+<ng-content select="ui-icon-button[prefix]"></ng-content>
+
+<!-- Input field slot (required) -->
+<ng-content select="input[type=text]"></ng-content>
+
+<!-- Actions container -->
+<div class="ui-search-bar__actions">
+  <!-- Clear button slot -->
+  <ng-content select="ui-search-bar-clear"></ng-content>
+
+  <!-- Suffix icon slot -->
+  <ng-content select="ui-icon-button"></ng-content>
+</div>
+```
+
+#### Host Classes
+
+- `ui-search-bar` - Always applied
+- `ui-search-bar__main` - When `appearance` is `'main'`
+- `ui-search-bar__results` - When `appearance` is `'results'`
+
+#### Implementation Details
+
+- Uses `contentChild.required()` to access the projected `NgControl`
+- Automatically retrieves the input's `ElementRef` for focus management
+- Computed `appearanceClass` updates reactively based on input signal
+
+### UiSearchBarClearComponent
+
+Standalone component that provides clear/reset functionality for the search input.
+
+**Selector:** `ui-search-bar-clear`
+
+#### Inputs
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `value` | `unknown` | `undefined` | Value to set when clearing (defaults to `null` if not provided) |
+
+#### Features
+
+- Displays close icon (`isaActionClose`) from `@isa/icons`
+- Automatically resets the parent search bar's form control
+- Restores focus to the input field after reset (using `asapScheduler`)
+- Standalone component with `ViewEncapsulation.None`
+
+#### Host Attributes
+
+- **Class**: `ui-search-bar__action__close`
+- **Click Handler**: Triggers `reset()` method
+- **Data Attribute**: `data-which="clear-search-icon"` for E2E testing
+
+#### Methods
+
+##### `reset(value?: unknown): void`
+
+Resets the search input to the specified value and restores focus.
+
+**Parameters:**
+- `value?: unknown` - Optional override value (uses `value` input if not provided)
+
+**Behavior:**
+1. Calls `inputControl().reset(resetValue)` on the parent search bar's form control
+2. Schedules focus restoration using `asapScheduler`
+3. Focuses the input element via `inputControlElementRef()`
+
+## Usage Examples
+
+### Basic Search Bar
+
+```typescript
+import { Component } from '@angular/core';
+import { FormControl, ReactiveFormsModule } from '@angular/forms';
+import { UiSearchBarComponent, UiSearchBarClearComponent } from '@isa/ui/search-bar';
+import { IconButtonComponent } from '@isa/ui/buttons';
+import { NgIconComponent, provideIcons } from '@ng-icons/core';
+import { isaActionSearch } from '@isa/icons';
+
+@Component({
+  selector: 'app-product-search',
+  standalone: true,
+  imports: [
+    ReactiveFormsModule,
+    UiSearchBarComponent,
+    UiSearchBarClearComponent,
+    IconButtonComponent
+  ],
+  providers: [provideIcons({ isaActionSearch })],
+  template: `
+    <ui-search-bar>
+      <input
+        type="text"
+        [formControl]="searchControl"
+        placeholder="Search products..."
+        data-what="product-search-input"
+        data-which="main-search"
+      />
+      <ui-search-bar-clear></ui-search-bar-clear>
+      <ui-icon-button
+        name="isaActionSearch"
+        (click)="performSearch()"
+        data-what="search-button"
+      ></ui-icon-button>
+    </ui-search-bar>
+  `
+})
+export class ProductSearchComponent {
+  searchControl = new FormControl('');
+
+  performSearch(): void {
+    const query = this.searchControl.value;
+    console.log('Searching for:', query);
+  }
+}
+```
+
+### Results Filter Bar
+
+```typescript
+import { Component, computed, signal } from '@angular/core';
+import { FormControl, ReactiveFormsModule } from '@angular/forms';
+import { toSignal } from '@angular/core/rxjs-interop';
+import { UiSearchBarComponent, UiSearchBarClearComponent } from '@isa/ui/search-bar';
+import { IconButtonComponent } from '@isa/ui/buttons';
+
+@Component({
+  selector: 'app-results-filter',
+  standalone: true,
+  imports: [
+    ReactiveFormsModule,
+    UiSearchBarComponent,
+    UiSearchBarClearComponent,
+    IconButtonComponent
+  ],
+  template: `
+    <ui-search-bar appearance="results">
+      <ui-icon-button prefix name="isaActionSearch"></ui-icon-button>
+      <input
+        type="text"
+        [formControl]="filterControl"
+        placeholder="Filter {{ totalResults() }} results..."
+        data-what="results-filter-input"
+      />
+      <ui-search-bar-clear></ui-search-bar-clear>
+    </ui-search-bar>
+
+    <div class="results">
+      @for (item of filteredResults(); track item.id) {
+        <div class="result-item">{{ item.name }}</div>
+      }
+    </div>
+  `
+})
+export class ResultsFilterComponent {
+  filterControl = new FormControl('');
+  filterValue = toSignal(this.filterControl.valueChanges, { initialValue: '' });
+
+  allResults = signal([
+    { id: 1, name: 'Product A' },
+    { id: 2, name: 'Product B' },
+    { id: 3, name: 'Product C' }
+  ]);
+
+  filteredResults = computed(() => {
+    const filter = this.filterValue()?.toLowerCase() || '';
+    return this.allResults().filter(item =>
+      item.name.toLowerCase().includes(filter)
+    );
+  });
+
+  totalResults = computed(() => this.allResults().length);
+}
+```
+
+### With Custom Reset Value
+
+```typescript
+@Component({
+  selector: 'app-category-search',
+  standalone: true,
+  imports: [
+    ReactiveFormsModule,
+    UiSearchBarComponent,
+    UiSearchBarClearComponent,
+    IconButtonComponent
+  ],
+  template: `
+    <ui-search-bar>
+      <input
+        type="text"
+        [formControl]="searchControl"
+        placeholder="Search in {{ currentCategory }}..."
+      />
+      <!-- Reset to current category instead of empty string -->
+      <ui-search-bar-clear [value]="currentCategory"></ui-search-bar-clear>
+      <ui-icon-button name="isaActionSearch"></ui-icon-button>
+    </ui-search-bar>
+  `
+})
+export class CategorySearchComponent {
+  currentCategory = 'Electronics';
+  searchControl = new FormControl(this.currentCategory);
+}
+```
+
+### Reactive Search with Debouncing
+
+```typescript
+import { Component, inject, OnInit } from '@angular/core';
+import { FormControl, ReactiveFormsModule } from '@angular/forms';
+import { debounceTime, distinctUntilChanged } from 'rxjs/operators';
+import { UiSearchBarComponent, UiSearchBarClearComponent } from '@isa/ui/search-bar';
+
+@Component({
+  selector: 'app-live-search',
+  standalone: true,
+  imports: [
+    ReactiveFormsModule,
+    UiSearchBarComponent,
+    UiSearchBarClearComponent,
+    IconButtonComponent
+  ],
+  template: `
+    <ui-search-bar>
+      <input
+        type="text"
+        [formControl]="searchControl"
+        placeholder="Type to search..."
+      />
+      <ui-search-bar-clear></ui-search-bar-clear>
+      <ui-icon-button name="isaActionSearch"></ui-icon-button>
+    </ui-search-bar>
+
+    @if (isSearching()) {
+      <div class="loading">Searching...</div>
+    }
+
+    <div class="search-results">
+      @for (result of searchResults(); track result.id) {
+        <div>{{ result.title }}</div>
+      }
+    </div>
+  `
+})
+export class LiveSearchComponent implements OnInit {
+  #searchService = inject(SearchService);
+
+  searchControl = new FormControl('');
+  isSearching = signal(false);
+  searchResults = signal<SearchResult[]>([]);
+
+  ngOnInit() {
+    this.searchControl.valueChanges
+      .pipe(
+        debounceTime(300),
+        distinctUntilChanged()
+      )
+      .subscribe(query => {
+        if (query) {
+          this.performSearch(query);
+        } else {
+          this.searchResults.set([]);
+        }
+      });
+  }
+
+  async performSearch(query: string): Promise<void> {
+    this.isSearching.set(true);
+    try {
+      const results = await this.#searchService.search(query);
+      this.searchResults.set(results);
+    } finally {
+      this.isSearching.set(false);
+    }
+  }
+}
+```
+
+### Advanced Multi-Slot Layout
+
+```html
+<ui-search-bar appearance="main">
+  <!-- Prefix icon for visual context -->
+  <ui-icon-button
+    prefix
+    name="isaActionSearch"
+    color="neutral"
+    data-what="search-prefix-icon"
+  ></ui-icon-button>
+
+  <!-- Main input field -->
+  <input
+    type="text"
+    [formControl]="searchControl"
+    placeholder="Search by name, SKU, or barcode..."
+    (keydown.enter)="performSearch()"
+    data-what="advanced-search-input"
+  />
+
+  <!-- Clear button (only visible when input has value) -->
+  @if (searchControl.value) {
+    <ui-search-bar-clear data-what="clear-search"></ui-search-bar-clear>
+  }
+
+  <!-- Search action button -->
+  <ui-icon-button
+    name="isaActionSearch"
+    color="brand"
+    [pending]="isSearching()"
+    (click)="performSearch()"
+    data-what="search-submit-button"
+  ></ui-icon-button>
+</ui-search-bar>
+```
+
+## Styling and Customization
+
+### Host Classes
+
+The component applies dynamic CSS classes based on appearance:
+
+```typescript
+// Main appearance
+<ui-search-bar class="ui-search-bar ui-search-bar__main">
+
+// Results appearance
+<ui-search-bar class="ui-search-bar ui-search-bar__results">
+```
+
+### Custom Styles
+
+Override the default styles using CSS:
+
+```scss
+// Customize main search bar
+.ui-search-bar__main {
+  background-color: #ffffff;
+  border: 2px solid #e0e0e0;
+  border-radius: 8px;
+  padding: 0.5rem;
+
+  input {
+    font-size: 1rem;
+    color: #333;
+  }
+}
+
+// Customize results filter bar
+.ui-search-bar__results {
+  background-color: #f5f5f5;
+  border: 1px solid #d0d0d0;
+  border-radius: 4px;
+
+  input {
+    font-size: 0.875rem;
+    color: #666;
+  }
+}
+
+// Customize actions container
+.ui-search-bar__actions {
+  display: flex;
+  gap: 0.5rem;
+  align-items: center;
+}
+
+// Customize clear button
+.ui-search-bar__action__close {
+  cursor: pointer;
+  color: #999;
+  transition: color 0.2s;
+
+  &:hover {
+    color: #333;
+  }
+}
+```
+
+### ViewEncapsulation
+
+Both components use `ViewEncapsulation.None`, allowing for:
+- Global theme customization
+- Consistent styling across the application
+- Easy CSS variable integration
+
+## Architecture Notes
+
+### Design Pattern
+
+The library uses a **Container + Action Component** pattern:
+
+```
+UiSearchBarComponent (Container)
+       ↓
+Content Projection (Composition)
+       ↓
+UiSearchBarClearComponent (Action)
+```
+
+### Content Child Pattern
+
+The search bar accesses projected content using `contentChild`:
+
+```typescript
+inputControl = contentChild.required(NgControl, { read: NgControl });
+inputControlElementRef = contentChild.required(NgControl, { read: ElementRef });
+```
+
+This provides:
+- Type-safe access to the form control
+- Direct DOM element reference for focus management
+- Compile-time validation that required content is projected
+
+### Focus Management
+
+The clear button uses `asapScheduler` to restore focus asynchronously:
+
+```typescript
+reset(value?: unknown): void {
+  const resetValue = value ?? this.value();
+  this.searchBar.inputControl().reset(resetValue);
+
+  // Schedule focus after change detection
+  asapScheduler.schedule(() => {
+    this.searchBar.inputControlElementRef().nativeElement.focus();
+  });
+}
+```
+
+This ensures:
+- DOM updates complete before focus
+- Smooth user experience
+- No timing race conditions
+
+### Parent-Child Communication
+
+`UiSearchBarClearComponent` injects its parent:
+
+```typescript
+private searchBar = inject(UiSearchBarComponent);
+```
+
+This enables:
+- Direct access to form control
+- Focus restoration on input element
+- Tight coupling between clear button and search bar
+
+### Performance Considerations
+
+1. **OnPush Change Detection** - Both components use OnPush strategy
+2. **Computed Appearance Class** - Reactively updates without manual tracking
+3. **Signal-Based Inputs** - Efficient change propagation
+4. **Minimal DOM Operations** - Focus management only when needed
+
+## Testing
+
+The library uses **Jest** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for search-bar
+npx nx test ui-search-bar --skip-nx-cache
+
+# Run tests with coverage
+npx nx test ui-search-bar --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test ui-search-bar --watch
+```
+
+### Test Coverage
+
+Tests should cover:
+
+- **Appearance modes** - Correct class application for main and results
+- **Content projection** - Input and icon slots work correctly
+- **Clear functionality** - Reset and focus restoration
+- **Form control integration** - NgControl binding and updates
+- **Focus management** - Input receives focus after clear
+- **E2E attributes** - `data-what` and `data-which` attributes present
+
+### Example Test
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { FormControl, ReactiveFormsModule } from '@angular/forms';
+import { Component } from '@angular/core';
+import { UiSearchBarComponent, UiSearchBarClearComponent } from '@isa/ui/search-bar';
+
+@Component({
+  standalone: true,
+  imports: [ReactiveFormsModule, UiSearchBarComponent, UiSearchBarClearComponent],
+  template: `
+    <ui-search-bar [appearance]="appearance">
+      <input type="text" [formControl]="searchControl" />
+      <ui-search-bar-clear></ui-search-bar-clear>
+    </ui-search-bar>
+  `
+})
+class TestComponent {
+  searchControl = new FormControl('test value');
+  appearance: SearchbarAppearance = 'main';
+}
+
+describe('UiSearchBarComponent', () => {
+  let fixture: ComponentFixture<TestComponent>;
+  let component: TestComponent;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      imports: [TestComponent]
+    });
+    fixture = TestBed.createComponent(TestComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should apply main appearance class', () => {
+    const element = fixture.nativeElement.querySelector('.ui-search-bar');
+    expect(element.classList.contains('ui-search-bar__main')).toBe(true);
+  });
+
+  it('should clear input when clear button is clicked', () => {
+    const clearButton = fixture.nativeElement.querySelector('.ui-search-bar__action__close');
+    clearButton.click();
+    fixture.detectChanges();
+
+    expect(component.searchControl.value).toBeNull();
+  });
+
+  it('should restore focus after clear', async () => {
+    const input = fixture.nativeElement.querySelector('input');
+    const clearButton = fixture.nativeElement.querySelector('.ui-search-bar__action__close');
+
+    clearButton.click();
+    await fixture.whenStable();
+
+    expect(document.activeElement).toBe(input);
+  });
+});
+```
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework (v20.1.2)
+- `@angular/forms` - Angular Forms for NgControl integration
+- `@ng-icons/core` - Icon component system
+- `@isa/icons` - ISA icon library
+- `rxjs` - RxJS for `asapScheduler`
+
+### Optional Dependencies
+
+- `@isa/ui/buttons` - For icon button components (recommended)
+
+### Path Alias
+
+Import from: `@isa/ui/search-bar`
+
+### Peer Dependencies
+
+- Angular 20.1.2 or higher
+- TypeScript 5.8.3 or higher
+
+## Best Practices
+
+### 1. Always Provide E2E Attributes
+
+Include `data-what` and `data-which` attributes for testing:
+
+```html
+<ui-search-bar>
+  <input
+    type="text"
+    [formControl]="searchControl"
+    data-what="search-input"
+    data-which="product-search"
+  />
+  <ui-search-bar-clear data-what="clear-button"></ui-search-bar-clear>
+</ui-search-bar>
+```
+
+### 2. Use Reactive Forms
+
+Always use `FormControl` for proper two-way binding:
+
+```typescript
+// Good: Reactive form control
+searchControl = new FormControl('');
+
+// Bad: ngModel or direct value binding
+searchValue = '';
+```
+
+### 3. Debounce Search Operations
+
+For live search, always debounce user input:
+
+```typescript
+ngOnInit() {
+  this.searchControl.valueChanges
+    .pipe(
+      debounceTime(300),
+      distinctUntilChanged()
+    )
+    .subscribe(query => this.search(query));
+}
+```
+
+### 4. Choose Appropriate Appearance
+
+Use `'main'` for primary search, `'results'` for filtering:
+
+```html
+<!-- Primary search interface -->
+<ui-search-bar appearance="main">...</ui-search-bar>
+
+<!-- Results filtering -->
+<ui-search-bar appearance="results">...</ui-search-bar>
+```
+
+### 5. Handle Empty States
+
+Provide visual feedback when search returns no results:
+
+```html
+<ui-search-bar>
+  <input [formControl]="searchControl" />
+  <ui-search-bar-clear></ui-search-bar-clear>
+</ui-search-bar>
+
+@if (searchControl.value && results().length === 0) {
+  <div class="empty-state">No results found</div>
+}
+```
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/ui/skeleton-loader/README.md b/libs/ui/skeleton-loader/README.md
index bec3029c6..d26241bfd 100644
--- a/libs/ui/skeleton-loader/README.md
+++ b/libs/ui/skeleton-loader/README.md
@@ -1,7 +1,482 @@
-# ui-skeleton-loader
+# @isa/ui/skeleton-loader
 
-This library was generated with [Nx](https://nx.dev).
+A lightweight Angular structural directive and component for displaying skeleton loading states during asynchronous operations.
 
-## Running unit tests
+## Overview
 
-Run `nx test ui-skeleton-loader` to execute the unit tests.
+The Skeleton Loader library provides a simple yet effective way to show loading placeholders while content is being fetched. It uses a structural directive pattern that conditionally replaces content with an animated skeleton loader, improving perceived performance and user experience during data loading.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Styling and Customization](#styling-and-customization)
+- [Architecture Notes](#architecture-notes)
+- [Testing](#testing)
+- [Dependencies](#dependencies)
+
+## Features
+
+- **Structural directive pattern** - Seamlessly replaces content with skeleton loader
+- **Signal-based reactivity** - Uses Angular signals for efficient change detection
+- **Customizable dimensions** - Configure width and height via directive inputs
+- **OnPush change detection** - Optimized for performance
+- **Minimal footprint** - Lightweight implementation with no external dependencies
+- **Smooth transitions** - Automatically handles view switching between loading and content states
+- **Standalone component** - Can be used independently of the directive
+
+## Quick Start
+
+### 1. Import the Directive
+
+```typescript
+import { Component } from '@angular/core';
+import { SkeletonLoaderDirective } from '@isa/ui/skeleton-loader';
+
+@Component({
+  selector: 'app-product-list',
+  standalone: true,
+  imports: [SkeletonLoaderDirective],
+  template: '...'
+})
+export class ProductListComponent {
+  isLoading = true;
+}
+```
+
+### 2. Basic Usage
+
+```html
+<!-- Replace content with skeleton while loading -->
+<div *uiSkeletonLoader="isLoading">
+  <h2>Product Name</h2>
+  <p>Product description goes here...</p>
+</div>
+```
+
+### 3. Custom Dimensions
+
+```html
+<!-- Specify exact dimensions for the skeleton -->
+<div *uiSkeletonLoader="isLoading; width: '200px'; height: '50px'">
+  Content to hide while loading
+</div>
+```
+
+### 4. Using the Component Directly
+
+```typescript
+import { SkeletonLoaderComponent } from '@isa/ui/skeleton-loader';
+
+@Component({
+  selector: 'app-card',
+  standalone: true,
+  imports: [SkeletonLoaderComponent],
+  template: `
+    @if (isLoading) {
+      <ui-skeleton-loader style="width: 100%; height: 200px;"></ui-skeleton-loader>
+    } @else {
+      <div class="card-content">{{ content }}</div>
+    }
+  `
+})
+export class CardComponent {
+  isLoading = true;
+  content = '';
+}
+```
+
+## API Reference
+
+### SkeletonLoaderDirective
+
+Structural directive that conditionally replaces its content with a skeleton loader.
+
+**Selector:** `[uiSkeletonLoader]`
+
+#### Inputs
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `uiSkeletonLoader` | `boolean` | `false` | When `true`, shows skeleton loader; when `false`, shows original content |
+| `uiSkeletonLoaderWidth` | `string \| undefined` | `'inherit'` | CSS width value for the skeleton loader (e.g., '100px', '50%', 'inherit') |
+| `uiSkeletonLoaderHeight` | `string \| undefined` | `'inherit'` | CSS height value for the skeleton loader (e.g., '20px', '100%', 'inherit') |
+
+#### Implementation Details
+
+- Uses `ViewContainerRef` to dynamically create/destroy views
+- Employs `effect()` for reactive rendering based on input signals
+- Automatically clears previous view before creating new one
+- Applies dimension styles using `untracked()` to prevent circular updates
+
+### SkeletonLoaderComponent
+
+Standalone component that renders a skeleton loading animation.
+
+**Selector:** `ui-skeleton-loader`
+
+#### Features
+
+- OnPush change detection strategy
+- ViewEncapsulation.None for global styling
+- Host class: `ui-skeleton-loader`
+- Single animated bar element with class `ui-skeleton-loader-bar`
+
+#### Template Structure
+
+```html
+<div class="ui-skeleton-loader-bar"></div>
+```
+
+## Usage Examples
+
+### Basic Loading State
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { SkeletonLoaderDirective } from '@isa/ui/skeleton-loader';
+
+@Component({
+  selector: 'app-user-profile',
+  standalone: true,
+  imports: [SkeletonLoaderDirective],
+  template: `
+    <div *uiSkeletonLoader="isLoading()">
+      <h1>{{ user.name }}</h1>
+      <p>{{ user.email }}</p>
+    </div>
+  `
+})
+export class UserProfileComponent {
+  isLoading = signal(true);
+  user = { name: '', email: '' };
+
+  ngOnInit() {
+    // Simulate API call
+    setTimeout(() => {
+      this.user = { name: 'John Doe', email: 'john@example.com' };
+      this.isLoading.set(false);
+    }, 2000);
+  }
+}
+```
+
+### List with Multiple Skeletons
+
+```html
+<div class="product-list">
+  @for (item of items; track item.id) {
+    <div
+      class="product-card"
+      *uiSkeletonLoader="isLoading; width: '100%'; height: '120px'"
+    >
+      <img [src]="item.image" alt="{{ item.name }}">
+      <h3>{{ item.name }}</h3>
+      <p>{{ item.price | currency }}</p>
+    </div>
+  }
+</div>
+```
+
+### Table Row Skeletons
+
+```html
+<table class="data-table">
+  <thead>
+    <tr>
+      <th>Name</th>
+      <th>Email</th>
+      <th>Status</th>
+    </tr>
+  </thead>
+  <tbody>
+    @for (row of tableData; track row.id) {
+      <tr *uiSkeletonLoader="isLoadingRow(row.id); height: '48px'">
+        <td>{{ row.name }}</td>
+        <td>{{ row.email }}</td>
+        <td>{{ row.status }}</td>
+      </tr>
+    }
+  </tbody>
+</table>
+```
+
+### Using with RxJS Observables
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { toSignal } from '@angular/core/rxjs-interop';
+import { map } from 'rxjs/operators';
+import { SkeletonLoaderDirective } from '@isa/ui/skeleton-loader';
+
+@Component({
+  selector: 'app-data-viewer',
+  standalone: true,
+  imports: [SkeletonLoaderDirective],
+  template: `
+    <div *uiSkeletonLoader="isLoading(); width: '100%'; height: '400px'">
+      @if (data(); as dataValue) {
+        <pre>{{ dataValue | json }}</pre>
+      }
+    </div>
+  `
+})
+export class DataViewerComponent {
+  #dataService = inject(DataService);
+
+  data$ = this.#dataService.getData();
+  data = toSignal(this.data$);
+  isLoading = toSignal(
+    this.data$.pipe(map(data => !data)),
+    { initialValue: true }
+  );
+}
+```
+
+### Standalone Component Usage
+
+```html
+<!-- When you need direct control over skeleton rendering -->
+<div class="custom-container">
+  @if (isLoading) {
+    <ui-skeleton-loader
+      style="width: 100%; height: 200px; margin-bottom: 1rem;"
+    ></ui-skeleton-loader>
+    <ui-skeleton-loader
+      style="width: 80%; height: 100px;"
+    ></ui-skeleton-loader>
+  } @else {
+    <div class="actual-content">
+      {{ content }}
+    </div>
+  }
+</div>
+```
+
+## Styling and Customization
+
+### Default Styling
+
+The skeleton loader applies the following host classes:
+- `ui-skeleton-loader` - Applied to the component host element
+- `ui-skeleton-loader-bar` - Applied to the animated bar element
+
+### Custom Styles
+
+You can customize the skeleton appearance using CSS:
+
+```scss
+// Custom skeleton colors and animation
+.ui-skeleton-loader {
+  background-color: #f0f0f0;
+  border-radius: 4px;
+}
+
+.ui-skeleton-loader-bar {
+  background: linear-gradient(
+    90deg,
+    #f0f0f0 0%,
+    #e0e0e0 50%,
+    #f0f0f0 100%
+  );
+  animation: skeleton-loading 1.5s ease-in-out infinite;
+}
+
+@keyframes skeleton-loading {
+  0% { transform: translateX(-100%); }
+  100% { transform: translateX(100%); }
+}
+```
+
+### Dimension Inheritance
+
+When `width` or `height` are not specified (or set to `'inherit'`), the skeleton loader inherits dimensions from its parent container:
+
+```html
+<!-- Skeleton inherits parent's dimensions -->
+<div style="width: 300px; height: 150px;">
+  <div *uiSkeletonLoader="isLoading">
+    Content
+  </div>
+</div>
+```
+
+### ViewEncapsulation
+
+The component uses `ViewEncapsulation.None`, allowing global styles to apply. This enables:
+- Consistent styling across the application
+- Easy theming via global CSS variables
+- Override styles from parent components
+
+## Architecture Notes
+
+### Design Pattern
+
+The library follows the **Structural Directive + Presentation Component** pattern:
+
+```
+SkeletonLoaderDirective (Structural Logic)
+       ↓
+Creates/Destroys views dynamically
+       ↓
+SkeletonLoaderComponent (Presentation)
+```
+
+### Signal-Based Reactivity
+
+The directive uses Angular signals for optimal performance:
+
+```typescript
+// Reactive rendering
+render = effect(() => {
+  const condition = this.uiSkeletonLoader();
+
+  if (condition && !this.componentRef) {
+    // Show skeleton
+  } else if (!condition && !this.embeddedViewRef) {
+    // Show content
+  }
+});
+
+// Reactive style updates
+updateStyles = effect(() => {
+  this.applyStyles();
+});
+```
+
+### View Management
+
+The directive efficiently manages view lifecycle:
+
+1. **Loading State** (`condition = true`):
+   - Clears existing views
+   - Creates `SkeletonLoaderComponent` instance
+   - Applies dimension styles
+   - Clears embedded view reference
+
+2. **Loaded State** (`condition = false`):
+   - Clears existing views
+   - Creates embedded view from template
+   - Clears component reference
+
+### Memory Management
+
+- Component/view references are properly cleaned up
+- Uses `untracked()` to prevent circular signal updates
+- OnPush change detection reduces unnecessary checks
+
+### Performance Considerations
+
+1. **Minimal DOM Operations** - Only creates/destroys views when state changes
+2. **Signal Efficiency** - Uses computed values and effects for reactive updates
+3. **OnPush Strategy** - Component only checks when inputs change
+4. **Untracked Styles** - Style application doesn't trigger additional effects
+
+## Testing
+
+The library uses **Jest** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for skeleton-loader
+npx nx test ui-skeleton-loader --skip-nx-cache
+
+# Run tests with coverage
+npx nx test ui-skeleton-loader --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test ui-skeleton-loader --watch
+```
+
+### Test Coverage
+
+The library includes comprehensive tests covering:
+
+- **Directive behavior** - View creation/destruction based on condition
+- **Dimension application** - Width/height style application
+- **Signal reactivity** - Proper effect execution
+- **View lifecycle** - Component and template ref management
+- **Edge cases** - Undefined dimensions, rapid state changes
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework (v20.1.2)
+
+### Path Alias
+
+Import from: `@isa/ui/skeleton-loader`
+
+### Peer Dependencies
+
+- Angular 20.1.2 or higher
+- TypeScript 5.8.3 or higher
+
+## Best Practices
+
+### 1. Use for Async Operations
+
+Always tie the skeleton loader to actual loading states:
+
+```typescript
+// Good: Tied to actual data loading
+isLoading = toSignal(this.data$.pipe(map(data => !data)));
+
+// Bad: Arbitrary timeout
+setTimeout(() => this.isLoading = false, 1000);
+```
+
+### 2. Match Skeleton to Content
+
+Ensure skeleton dimensions approximate actual content:
+
+```html
+<!-- Good: Skeleton matches content dimensions -->
+<div *uiSkeletonLoader="isLoading; width: '100%'; height: '48px'">
+  <h2 class="text-xl">{{ title }}</h2> <!-- ~48px height -->
+</div>
+
+<!-- Bad: Skeleton much smaller than content -->
+<div *uiSkeletonLoader="isLoading; height: '20px'">
+  <div class="large-card">...</div> <!-- 300px height -->
+</div>
+```
+
+### 3. Avoid Nested Skeletons
+
+Don't nest skeleton loader directives:
+
+```html
+<!-- Bad: Nested skeletons -->
+<div *uiSkeletonLoader="isLoadingOuter">
+  <div *uiSkeletonLoader="isLoadingInner">
+    Content
+  </div>
+</div>
+
+<!-- Good: Single skeleton or separate skeletons -->
+<div *uiSkeletonLoader="isLoading">
+  <div>Content</div>
+</div>
+```
+
+### 4. Use Inherit for Flexible Layouts
+
+Let the skeleton inherit dimensions for responsive layouts:
+
+```html
+<!-- Skeleton automatically adapts to container -->
+<div class="responsive-container">
+  <div *uiSkeletonLoader="isLoading">
+    {{ content }}
+  </div>
+</div>
+```
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/ui/toolbar/README.md b/libs/ui/toolbar/README.md
index 2df66d20c..0960da60d 100644
--- a/libs/ui/toolbar/README.md
+++ b/libs/ui/toolbar/README.md
@@ -1,7 +1,614 @@
-# ui-toolbar
+# @isa/ui/toolbar
 
-This library was generated with [Nx](https://nx.dev).
+A flexible toolbar container component for Angular applications with configurable sizing and content projection.
 
-## Running unit tests
+## Overview
 
-Run `nx test ui-toolbar` to execute the unit tests.
+The Toolbar library provides a single component (`ui-toolbar`) that serves as a styled container for toolbar content. It supports two size variants (small and medium) and uses content projection to allow flexible composition of toolbar items such as buttons, inputs, and action controls.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Component API](#component-api)
+- [Usage Examples](#usage-examples)
+- [Styling and Customization](#styling-and-customization)
+- [Architecture Notes](#architecture-notes)
+- [Testing](#testing)
+- [Dependencies](#dependencies)
+
+## Features
+
+- **Two size variants** - Small and medium toolbar heights
+- **Content projection** - Full flexibility for toolbar content composition
+- **ViewEncapsulation.None** - Allows external styling
+- **OnPush change detection** - Optimized performance
+- **Signal-based sizing** - Reactive size computation with `computed()`
+- **Host class bindings** - Dynamic CSS class application
+- **Standalone component** - Modern Angular architecture
+
+## Quick Start
+
+### 1. Import Component
+
+```typescript
+import { Component } from '@angular/core';
+import { ToolbarComponent } from '@isa/ui/toolbar';
+
+@Component({
+  selector: 'app-page-header',
+  imports: [ToolbarComponent],
+  template: `...`
+})
+export class PageHeaderComponent {}
+```
+
+### 2. Basic Usage
+
+```html
+<ui-toolbar>
+  <h1>Page Title</h1>
+  <button>Action</button>
+</ui-toolbar>
+```
+
+### 3. Size Variants
+
+```html
+<!-- Medium toolbar (default) -->
+<ui-toolbar>
+  <span>Default medium toolbar</span>
+</ui-toolbar>
+
+<!-- Small toolbar -->
+<ui-toolbar [size]="'small'">
+  <span>Compact toolbar</span>
+</ui-toolbar>
+```
+
+## Component API
+
+### ToolbarComponent
+
+Container component for toolbar content with size variants.
+
+#### Selector
+```typescript
+'ui-toolbar'
+```
+
+#### Inputs
+
+| Input | Type | Default | Description |
+|-------|------|---------|-------------|
+| `size` | `ToolbarSize` | `'medium'` | Size variant of the toolbar |
+
+#### Size Options
+
+```typescript
+export const ToolbarSize = {
+  Small: 'small',
+  Medium: 'medium',
+} as const;
+
+export type ToolbarSize = (typeof ToolbarSize)[keyof typeof ToolbarSize];
+```
+
+#### Computed Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `sizeClass()` | `string` | Computed CSS class based on size (`ui-toolbar__small` or `ui-toolbar__medium`) |
+
+#### Host Bindings
+- `class`: `['ui-toolbar', sizeClass()]` - Base class and size-specific class
+
+#### Template
+```html
+<ng-content></ng-content>
+```
+
+#### Encapsulation
+- Uses `ViewEncapsulation.None` to allow external styling of toolbar content
+
+## Usage Examples
+
+### Page Header Toolbar
+
+```typescript
+import { Component } from '@angular/core';
+import { ToolbarComponent } from '@isa/ui/toolbar';
+import { ButtonComponent } from '@isa/ui/buttons';
+
+@Component({
+  selector: 'app-page-header',
+  imports: [ToolbarComponent, ButtonComponent],
+  template: `
+    <ui-toolbar>
+      <h1 class="page-title">Dashboard</h1>
+      <div class="toolbar-actions">
+        <ui-button (click)="refresh()">Refresh</ui-button>
+        <ui-button appearance="accent" (click)="create()">Create</ui-button>
+      </div>
+    </ui-toolbar>
+  `,
+  styles: [`
+    .page-title {
+      flex: 1;
+      margin: 0;
+    }
+    .toolbar-actions {
+      display: flex;
+      gap: 0.5rem;
+    }
+  `]
+})
+export class PageHeaderComponent {
+  refresh() { /* ... */ }
+  create() { /* ... */ }
+}
+```
+
+### Search Toolbar
+
+```typescript
+import { Component } from '@angular/core';
+import { ToolbarComponent, ToolbarSize } from '@isa/ui/toolbar';
+import { TextFieldComponent, InputControlDirective } from '@isa/ui/input-controls';
+
+@Component({
+  selector: 'app-search-toolbar',
+  imports: [ToolbarComponent, TextFieldComponent, InputControlDirective],
+  template: `
+    <ui-toolbar [size]="ToolbarSize.Small">
+      <ui-text-field>
+        <input uiInputControl type="text" placeholder="Search..." />
+      </ui-text-field>
+      <button (click)="search()">Search</button>
+    </ui-toolbar>
+  `
+})
+export class SearchToolbarComponent {
+  readonly ToolbarSize = ToolbarSize;
+
+  search() { /* ... */ }
+}
+```
+
+### Filter Toolbar with Multiple Controls
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { ToolbarComponent } from '@isa/ui/toolbar';
+import { DropdownButtonComponent, DropdownOptionComponent } from '@isa/ui/input-controls';
+
+@Component({
+  selector: 'app-filter-toolbar',
+  imports: [ToolbarComponent, DropdownButtonComponent, DropdownOptionComponent],
+  template: `
+    <ui-toolbar>
+      <span class="filter-label">Filters:</span>
+
+      <ui-dropdown [(value)]="selectedStatus" label="Status">
+        <ui-dropdown-option [value]="'all'">All</ui-dropdown-option>
+        <ui-dropdown-option [value]="'active'">Active</ui-dropdown-option>
+        <ui-dropdown-option [value]="'inactive'">Inactive</ui-dropdown-option>
+      </ui-dropdown>
+
+      <ui-dropdown [(value)]="selectedCategory" label="Category">
+        <ui-dropdown-option [value]="'all'">All</ui-dropdown-option>
+        <ui-dropdown-option [value]="'electronics'">Electronics</ui-dropdown-option>
+        <ui-dropdown-option [value]="'books'">Books</ui-dropdown-option>
+      </ui-dropdown>
+
+      <button (click)="resetFilters()">Reset</button>
+    </ui-toolbar>
+  `,
+  styles: [`
+    .filter-label {
+      font-weight: 600;
+      margin-right: 0.5rem;
+    }
+  `]
+})
+export class FilterToolbarComponent {
+  selectedStatus = signal('all');
+  selectedCategory = signal('all');
+
+  resetFilters() {
+    this.selectedStatus.set('all');
+    this.selectedCategory.set('all');
+  }
+}
+```
+
+### Dynamic Size Toolbar
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { ToolbarComponent, ToolbarSize } from '@isa/ui/toolbar';
+
+@Component({
+  selector: 'app-dynamic-toolbar',
+  imports: [ToolbarComponent],
+  template: `
+    <ui-toolbar [size]="currentSize()">
+      <span>Toolbar Content</span>
+      <button (click)="toggleSize()">Toggle Size</button>
+    </ui-toolbar>
+  `
+})
+export class DynamicToolbarComponent {
+  currentSize = signal<ToolbarSize>(ToolbarSize.Medium);
+
+  toggleSize() {
+    const newSize = this.currentSize() === ToolbarSize.Medium
+      ? ToolbarSize.Small
+      : ToolbarSize.Medium;
+    this.currentSize.set(newSize);
+  }
+}
+```
+
+### Toolbar with Icons and Actions
+
+```typescript
+import { Component } from '@angular/core';
+import { ToolbarComponent } from '@isa/ui/toolbar';
+import { NgIcon } from '@ng-icons/core';
+import { ButtonComponent } from '@isa/ui/buttons';
+
+@Component({
+  selector: 'app-actions-toolbar',
+  imports: [ToolbarComponent, ButtonComponent, NgIcon],
+  template: `
+    <ui-toolbar>
+      <div class="toolbar-section">
+        <ng-icon name="isaActionMenu" size="1.5rem"></ng-icon>
+        <span class="toolbar-title">Orders</span>
+      </div>
+
+      <div class="toolbar-section">
+        <ui-button (click)="export()">
+          <ng-icon name="isaActionDownload"></ng-icon>
+          Export
+        </ui-button>
+        <ui-button appearance="accent" (click)="createOrder()">
+          <ng-icon name="isaActionPlus"></ng-icon>
+          New Order
+        </ui-button>
+      </div>
+    </ui-toolbar>
+  `,
+  styles: [`
+    .toolbar-section {
+      display: flex;
+      align-items: center;
+      gap: 0.75rem;
+    }
+    .toolbar-title {
+      font-size: 1.25rem;
+      font-weight: 600;
+    }
+  `]
+})
+export class ActionsToolbarComponent {
+  export() { /* ... */ }
+  createOrder() { /* ... */ }
+}
+```
+
+### Responsive Toolbar with Breakpoints
+
+```typescript
+import { Component, computed } from '@angular/core';
+import { ToolbarComponent, ToolbarSize } from '@isa/ui/toolbar';
+import { breakpoint, Breakpoint } from '@isa/ui/layout';
+
+@Component({
+  selector: 'app-responsive-toolbar',
+  imports: [ToolbarComponent],
+  template: `
+    <ui-toolbar [size]="toolbarSize()">
+      @if (isDesktop()) {
+        <h1>Full Desktop Title</h1>
+        <div class="actions">
+          <button>Action 1</button>
+          <button>Action 2</button>
+          <button>Action 3</button>
+        </div>
+      } @else {
+        <h1>Mobile</h1>
+        <button>Menu</button>
+      }
+    </ui-toolbar>
+  `
+})
+export class ResponsiveToolbarComponent {
+  isDesktop = breakpoint([Breakpoint.Desktop, Breakpoint.DekstopL, Breakpoint.DekstopXL]);
+
+  toolbarSize = computed(() =>
+    this.isDesktop() ? ToolbarSize.Medium : ToolbarSize.Small
+  );
+}
+```
+
+## Styling and Customization
+
+### CSS Classes
+
+The component exposes the following CSS classes for styling:
+
+```css
+/* Base toolbar class */
+.ui-toolbar {
+  /* Base toolbar styles */
+}
+
+/* Medium toolbar (default) */
+.ui-toolbar__medium {
+  /* Medium size styles */
+}
+
+/* Small toolbar */
+.ui-toolbar__small {
+  /* Small size styles */
+}
+```
+
+### Example Styling
+
+```scss
+// Base toolbar styling
+.ui-toolbar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0 1rem;
+  background-color: var(--isa-surface-100);
+  border-bottom: 1px solid var(--isa-border-200);
+
+  // Medium toolbar (default height)
+  &.ui-toolbar__medium {
+    height: 4rem;
+    padding: 0 1.5rem;
+  }
+
+  // Small toolbar (compact height)
+  &.ui-toolbar__small {
+    height: 3rem;
+    padding: 0 1rem;
+    font-size: 0.875rem;
+  }
+}
+
+// Toolbar sections and layouts
+.ui-toolbar {
+  .toolbar-section {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+  }
+
+  .toolbar-title {
+    font-weight: 600;
+    font-size: 1.125rem;
+  }
+
+  .toolbar-actions {
+    display: flex;
+    gap: 0.5rem;
+    margin-left: auto;
+  }
+}
+```
+
+### Dark Theme Example
+
+```scss
+// Dark mode toolbar
+.dark-theme {
+  .ui-toolbar {
+    background-color: var(--isa-surface-900);
+    border-bottom-color: var(--isa-border-700);
+    color: var(--isa-text-inverse);
+  }
+}
+```
+
+## Architecture Notes
+
+### Size Management
+
+The component uses Angular signals for reactive size management:
+
+```typescript
+size = input<ToolbarSize>('medium');
+
+sizeClass = computed(() => `ui-toolbar__${this.size()}`);
+```
+
+Benefits:
+- **Automatic updates** - Size changes trigger class recomputation
+- **Type safety** - ToolbarSize type ensures valid values
+- **Performance** - OnPush detection with signals
+
+### ViewEncapsulation.None
+
+The component uses `ViewEncapsulation.None` to allow external styling:
+
+```typescript
+@Component({
+  encapsulation: ViewEncapsulation.None
+})
+```
+
+This enables:
+- Parent components can style toolbar content
+- Global styles can target toolbar elements
+- Flexible theme integration
+
+### Content Projection
+
+The toolbar uses simple content projection for maximum flexibility:
+
+```html
+<ng-content></ng-content>
+```
+
+This allows any content structure:
+- Buttons, inputs, dropdowns
+- Custom components
+- Icons and text
+- Complex layouts
+
+### Standalone Architecture
+
+The component is fully standalone with no dependencies:
+
+```typescript
+@Component({
+  standalone: true,
+  imports: []
+})
+```
+
+## Testing
+
+The library uses **Jest** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test ui-toolbar --skip-nx-cache
+
+# Run tests with coverage
+npx nx test ui-toolbar --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test ui-toolbar --watch
+```
+
+### Test Coverage
+
+The library should include tests covering:
+
+- **Component rendering** - Verifies toolbar renders correctly
+- **Size variants** - Tests both small and medium sizes
+- **Content projection** - Validates content appears correctly
+- **Class bindings** - Tests dynamic class application
+- **Signal reactivity** - Tests size changes update classes
+
+### Example Test
+
+```typescript
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+import { ToolbarComponent, ToolbarSize } from './toolbar.component';
+
+describe('ToolbarComponent', () => {
+  let component: ToolbarComponent;
+  let fixture: ComponentFixture<ToolbarComponent>;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      imports: [ToolbarComponent]
+    });
+    fixture = TestBed.createComponent(ToolbarComponent);
+    component = fixture.componentInstance;
+  });
+
+  it('should apply medium size by default', () => {
+    fixture.detectChanges();
+    expect(component.sizeClass()).toBe('ui-toolbar__medium');
+  });
+
+  it('should apply small size when specified', () => {
+    component.size = ToolbarSize.Small;
+    fixture.detectChanges();
+    expect(component.sizeClass()).toBe('ui-toolbar__small');
+  });
+
+  it('should project content correctly', () => {
+    const compiled = fixture.nativeElement;
+    compiled.innerHTML = '<span>Test Content</span>';
+    fixture.detectChanges();
+    expect(compiled.textContent).toContain('Test Content');
+  });
+});
+```
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - Angular framework (v20.1.2)
+
+### Path Alias
+
+Import from: `@isa/ui/toolbar`
+
+### No External Dependencies
+
+This component has no external dependencies beyond Angular core, making it lightweight and easy to integrate.
+
+## Best Practices
+
+1. **Consistent Sizing** - Use the same toolbar size throughout similar contexts (e.g., all page headers use medium)
+2. **Flexbox Layouts** - Structure toolbar content using flexbox for responsive behavior
+3. **Semantic HTML** - Use appropriate HTML elements within the toolbar (headings, buttons, etc.)
+4. **Accessibility** - Ensure toolbar controls are keyboard accessible and have proper ARIA labels
+5. **Content Organization** - Group related toolbar items visually using spacing and dividers
+6. **Responsive Design** - Consider using the breakpoint service to adapt toolbar content for different screen sizes
+
+## Common Patterns
+
+### Left-Right Layout
+
+```html
+<ui-toolbar>
+  <div class="toolbar-left">
+    <h1>Title</h1>
+    <span>Subtitle</span>
+  </div>
+  <div class="toolbar-right">
+    <button>Action 1</button>
+    <button>Action 2</button>
+  </div>
+</ui-toolbar>
+
+<style>
+  .ui-toolbar {
+    display: flex;
+    justify-content: space-between;
+  }
+</style>
+```
+
+### Three-Section Layout
+
+```html
+<ui-toolbar>
+  <div class="toolbar-left">Left content</div>
+  <div class="toolbar-center">Center content</div>
+  <div class="toolbar-right">Right content</div>
+</ui-toolbar>
+
+<style>
+  .ui-toolbar {
+    display: grid;
+    grid-template-columns: 1fr auto 1fr;
+    gap: 1rem;
+  }
+  .toolbar-center {
+    justify-self: center;
+  }
+  .toolbar-right {
+    justify-self: end;
+  }
+</style>
+```
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/utils/ean-validation/README.md b/libs/utils/ean-validation/README.md
index 70098773b..8cf1e55ce 100644
--- a/libs/utils/ean-validation/README.md
+++ b/libs/utils/ean-validation/README.md
@@ -1,7 +1,1160 @@
-# ean-validation
+# @isa/utils/ean-validation
 
-This library was generated with [Nx](https://nx.dev).
+Lightweight Angular utility library for validating EAN (European Article Number) barcodes with reactive forms integration and standalone validation functions.
 
-## Running unit tests
+## Overview
 
-Run `nx test ean-validation` to execute the unit tests.
+The EAN Validation library provides tools for validating 13-digit EAN barcodes in Angular applications. It includes both an Angular Forms validator for reactive form validation and a standalone utility function for programmatic validation. The library uses a simple regex-based approach for fast, efficient validation without external dependencies.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [EAN Format](#ean-format)
+- [Architecture Notes](#architecture-notes)
+- [Testing](#testing)
+- [Dependencies](#dependencies)
+
+## Features
+
+- **Angular Forms validator** - `eanValidator` for reactive form controls
+- **Standalone validation** - `isEan()` utility function for programmatic checks
+- **Regex-based validation** - Fast, efficient 13-digit EAN validation
+- **Zero dependencies** - No external libraries required
+- **Type-safe** - Full TypeScript support
+- **Null-safe** - Graceful handling of undefined/null values
+- **Lightweight** - Minimal bundle size impact
+- **Framework agnostic core** - Validation logic can be used outside Angular
+
+## Quick Start
+
+### 1. Reactive Form Validation
+
+```typescript
+import { Component } from '@angular/core';
+import { FormControl, FormGroup, ReactiveFormsModule } from '@angular/forms';
+import { eanValidator } from '@isa/utils/ean-validation';
+
+@Component({
+  selector: 'app-product-form',
+  standalone: true,
+  imports: [ReactiveFormsModule],
+  template: `
+    <form [formGroup]="productForm">
+      <label>
+        EAN:
+        <input formControlName="ean" type="text" />
+      </label>
+
+      @if (eanControl.errors?.['invalidEan']) {
+        <div class="error">
+          Please enter a valid 13-digit EAN
+        </div>
+      }
+    </form>
+  `
+})
+export class ProductFormComponent {
+  productForm = new FormGroup({
+    ean: new FormControl('', [eanValidator])
+  });
+
+  get eanControl() {
+    return this.productForm.get('ean')!;
+  }
+}
+```
+
+### 2. Programmatic Validation
+
+```typescript
+import { Component } from '@angular/core';
+import { isEan } from '@isa/utils/ean-validation';
+
+@Component({
+  selector: 'app-barcode-scanner',
+  template: `
+    <button (click)="validateBarcode('1234567890123')">
+      Validate Barcode
+    </button>
+  `
+})
+export class BarcodeScannerComponent {
+  validateBarcode(code: string): void {
+    if (isEan(code)) {
+      console.log('Valid EAN:', code);
+      // Process valid EAN
+    } else {
+      console.error('Invalid EAN:', code);
+      // Handle invalid EAN
+    }
+  }
+}
+```
+
+### 3. Combined Usage
+
+```typescript
+import { Component } from '@angular/core';
+import { FormControl, ReactiveFormsModule } from '@angular/forms';
+import { eanValidator, isEan } from '@isa/utils/ean-validation';
+
+@Component({
+  selector: 'app-product-search',
+  standalone: true,
+  imports: [ReactiveFormsModule],
+  template: `
+    <input
+      [formControl]="searchControl"
+      placeholder="Enter EAN"
+      (keyup.enter)="search()"
+    />
+
+    <button (click)="search()" [disabled]="!canSearch()">
+      Search
+    </button>
+  `
+})
+export class ProductSearchComponent {
+  searchControl = new FormControl('', [eanValidator]);
+
+  canSearch(): boolean {
+    const value = this.searchControl.value;
+    return !!value && isEan(value);
+  }
+
+  search(): void {
+    if (this.canSearch()) {
+      const ean = this.searchControl.value!;
+      console.log('Searching for:', ean);
+      // Perform search
+    }
+  }
+}
+```
+
+## Core Concepts
+
+### EAN (European Article Number)
+
+EAN is a 13-digit barcode standard used internationally for product identification:
+
+```
+1234567890123
+└───┬────┘││└─ Check digit
+    │     ││
+    │     │└── Product code
+    │     └─── Manufacturer code
+    └───────── Country/GS1 prefix
+```
+
+### Validation Rules
+
+The library validates EANs based on these criteria:
+
+1. **Length**: Must be exactly 13 digits
+2. **Content**: Must contain only numeric characters (0-9)
+3. **Format**: No spaces, dashes, or other separators allowed
+
+**Valid EANs:**
+```typescript
+'1234567890123' ✓ (13 digits, all numeric)
+'0000000000000' ✓ (13 digits, all numeric)
+'9999999999999' ✓ (13 digits, all numeric)
+```
+
+**Invalid EANs:**
+```typescript
+'123456789012'   ✗ (12 digits - too short)
+'12345678901234' ✗ (14 digits - too long)
+'123456789012A'  ✗ (contains letter)
+'1234-5678-9012' ✗ (contains dashes)
+' 1234567890123' ✗ (contains whitespace)
+''               ✗ (empty string - via isEan())
+undefined        ✗ (undefined - via isEan())
+```
+
+### Regex Pattern
+
+The validation uses a simple regex pattern:
+
+```typescript
+const EAN_REGEX = /^[0-9]{13}$/;
+```
+
+**Pattern breakdown:**
+- `^` - Start of string
+- `[0-9]` - Any digit from 0 to 9
+- `{13}` - Exactly 13 times
+- `$` - End of string
+
+## API Reference
+
+### eanValidator
+
+Angular Forms validator function for validating EAN input.
+
+**Type:** `ValidatorFn`
+
+**Signature:**
+```typescript
+eanValidator(control: AbstractControl): ValidationErrors | null
+```
+
+**Parameters:**
+- `control: AbstractControl` - The form control to validate
+
+**Returns:**
+- `null` - If the value is valid or empty/null
+- `{ invalidEan: true }` - If the value is invalid
+
+**Validation Behavior:**
+- **Empty values**: Returns `null` (considered valid - use `Validators.required` for required fields)
+- **Valid EAN**: Returns `null`
+- **Invalid EAN**: Returns `{ invalidEan: true }`
+
+**Example:**
+```typescript
+import { FormControl } from '@angular/forms';
+import { eanValidator } from '@isa/utils/ean-validation';
+
+const eanControl = new FormControl('', [eanValidator]);
+
+eanControl.setValue('1234567890123');
+console.log(eanControl.valid); // true
+
+eanControl.setValue('123');
+console.log(eanControl.errors); // { invalidEan: true }
+
+eanControl.setValue('');
+console.log(eanControl.valid); // true (empty is valid)
+```
+
+### isEan
+
+Standalone utility function for programmatic EAN validation.
+
+**Signature:**
+```typescript
+isEan(value: string | undefined): boolean
+```
+
+**Parameters:**
+- `value: string | undefined` - The value to validate
+
+**Returns:**
+- `true` - If the value is a valid 13-digit EAN
+- `false` - If the value is invalid, undefined, null, or empty
+
+**Validation Behavior:**
+- **undefined/null**: Returns `false`
+- **Empty string**: Returns `false`
+- **Valid EAN**: Returns `true`
+- **Invalid EAN**: Returns `false`
+
+**Example:**
+```typescript
+import { isEan } from '@isa/utils/ean-validation';
+
+isEan('1234567890123'); // true
+isEan('123');           // false
+isEan('');              // false
+isEan(undefined);       // false
+isEan(null);            // false (TypeScript allows via type coercion)
+```
+
+### EAN_REGEX
+
+Regular expression constant for EAN validation.
+
+**Type:** `RegExp`
+
+**Value:** `/^[0-9]{13}$/`
+
+**Note:** This is an internal constant. Prefer using `eanValidator` or `isEan()` for validation.
+
+**Example:**
+```typescript
+import { EAN_REGEX } from '@isa/utils/ean-validation';
+
+// Direct regex usage (not recommended)
+const isValid = EAN_REGEX.test('1234567890123');
+console.log(isValid); // true
+
+// Prefer using isEan() instead
+const isValidPreferred = isEan('1234567890123');
+```
+
+## Usage Examples
+
+### Basic Form Validation
+
+```typescript
+import { Component } from '@angular/core';
+import { FormControl, FormGroup, ReactiveFormsModule, Validators } from '@angular/forms';
+import { eanValidator } from '@isa/utils/ean-validation';
+
+@Component({
+  selector: 'app-product-form',
+  standalone: true,
+  imports: [ReactiveFormsModule],
+  template: `
+    <form [formGroup]="form" (ngSubmit)="onSubmit()">
+      <div class="form-field">
+        <label for="ean">Product EAN*</label>
+        <input
+          id="ean"
+          formControlName="ean"
+          type="text"
+          maxlength="13"
+          placeholder="1234567890123"
+        />
+
+        @if (ean.touched && ean.errors) {
+          <div class="errors">
+            @if (ean.errors['required']) {
+              <p class="error">EAN is required</p>
+            }
+            @if (ean.errors['invalidEan']) {
+              <p class="error">EAN must be exactly 13 digits</p>
+            }
+          </div>
+        }
+      </div>
+
+      <button type="submit" [disabled]="!form.valid">
+        Save Product
+      </button>
+    </form>
+  `
+})
+export class ProductFormComponent {
+  form = new FormGroup({
+    ean: new FormControl('', [
+      Validators.required,
+      eanValidator
+    ])
+  });
+
+  get ean() {
+    return this.form.get('ean')!;
+  }
+
+  onSubmit(): void {
+    if (this.form.valid) {
+      const productData = this.form.value;
+      console.log('Saving product:', productData);
+      // Save logic
+    }
+  }
+}
+```
+
+### Barcode Scanner Integration
+
+```typescript
+import { Component, inject, signal } from '@angular/core';
+import { isEan } from '@isa/utils/ean-validation';
+
+interface ScanResult {
+  code: string;
+  valid: boolean;
+  timestamp: Date;
+}
+
+@Component({
+  selector: 'app-barcode-scanner',
+  template: `
+    <div class="scanner">
+      <h2>Barcode Scanner</h2>
+
+      <button (click)="startScanning()">
+        Start Scanning
+      </button>
+
+      <div class="scan-history">
+        <h3>Scan History</h3>
+        @for (scan of scanHistory(); track scan.timestamp) {
+          <div
+            class="scan-result"
+            [class.valid]="scan.valid"
+            [class.invalid]="!scan.valid"
+          >
+            <span>{{ scan.code }}</span>
+            <span>{{ scan.valid ? '✓ Valid' : '✗ Invalid' }}</span>
+            <span>{{ scan.timestamp | date: 'short' }}</span>
+          </div>
+        }
+      </div>
+    </div>
+  `
+})
+export class BarcodeScannerComponent {
+  scanHistory = signal<ScanResult[]>([]);
+
+  startScanning(): void {
+    // Simulated barcode scan
+    this.processScan('1234567890123');
+  }
+
+  processScan(code: string): void {
+    const valid = isEan(code);
+
+    this.scanHistory.update(history => [
+      {
+        code,
+        valid,
+        timestamp: new Date()
+      },
+      ...history
+    ]);
+
+    if (valid) {
+      console.log('Valid EAN scanned:', code);
+      // Process valid EAN
+      this.lookupProduct(code);
+    } else {
+      console.error('Invalid EAN scanned:', code);
+      // Show error message
+    }
+  }
+
+  lookupProduct(ean: string): void {
+    // Product lookup logic
+  }
+}
+```
+
+### Search with Validation
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { FormControl, ReactiveFormsModule } from '@angular/forms';
+import { eanValidator, isEan } from '@isa/utils/ean-validation';
+
+@Component({
+  selector: 'app-product-search',
+  standalone: true,
+  imports: [ReactiveFormsModule],
+  template: `
+    <div class="search-container">
+      <input
+        [formControl]="searchControl"
+        type="text"
+        placeholder="Enter 13-digit EAN"
+        maxlength="13"
+        (keyup.enter)="search()"
+      />
+
+      <button
+        (click)="search()"
+        [disabled]="!isValidEan()"
+      >
+        Search
+      </button>
+
+      @if (searchControl.touched && searchControl.errors?.['invalidEan']) {
+        <p class="error">
+          Please enter a valid 13-digit EAN
+        </p>
+      }
+
+      @if (searchResult()) {
+        <div class="result">
+          <h3>Product Found</h3>
+          <p>EAN: {{ searchResult()!.ean }}</p>
+          <p>Name: {{ searchResult()!.name }}</p>
+        </div>
+      }
+
+      @if (notFound()) {
+        <p class="error">No product found with EAN: {{ lastSearch() }}</p>
+      }
+    </div>
+  `
+})
+export class ProductSearchComponent {
+  searchControl = new FormControl('', [eanValidator]);
+
+  searchResult = signal<{ ean: string; name: string } | null>(null);
+  notFound = signal(false);
+  lastSearch = signal('');
+
+  isValidEan(): boolean {
+    const value = this.searchControl.value;
+    return !!value && isEan(value);
+  }
+
+  search(): void {
+    if (!this.isValidEan()) return;
+
+    const ean = this.searchControl.value!;
+    this.lastSearch.set(ean);
+
+    // Simulated product lookup
+    const product = this.mockProductLookup(ean);
+
+    if (product) {
+      this.searchResult.set(product);
+      this.notFound.set(false);
+    } else {
+      this.searchResult.set(null);
+      this.notFound.set(true);
+    }
+  }
+
+  mockProductLookup(ean: string): { ean: string; name: string } | null {
+    // Mock implementation
+    return { ean, name: `Product ${ean}` };
+  }
+}
+```
+
+### Batch Validation
+
+```typescript
+import { Component, signal } from '@angular/core';
+import { isEan } from '@isa/utils/ean-validation';
+
+interface ValidationResult {
+  ean: string;
+  valid: boolean;
+}
+
+@Component({
+  selector: 'app-batch-validator',
+  template: `
+    <div class="batch-validator">
+      <h2>Batch EAN Validator</h2>
+
+      <textarea
+        [value]="inputEans()"
+        (input)="inputEans.set($any($event.target).value)"
+        placeholder="Enter EANs (one per line)"
+        rows="10"
+      ></textarea>
+
+      <button (click)="validate()">Validate All</button>
+
+      @if (results().length > 0) {
+        <div class="results">
+          <h3>Validation Results</h3>
+          <p>
+            Valid: {{ validCount() }} / {{ results().length }}
+          </p>
+
+          <table>
+            <thead>
+              <tr>
+                <th>EAN</th>
+                <th>Status</th>
+              </tr>
+            </thead>
+            <tbody>
+              @for (result of results(); track result.ean) {
+                <tr [class.valid]="result.valid" [class.invalid]="!result.valid">
+                  <td>{{ result.ean }}</td>
+                  <td>{{ result.valid ? '✓ Valid' : '✗ Invalid' }}</td>
+                </tr>
+              }
+            </tbody>
+          </table>
+        </div>
+      }
+    </div>
+  `
+})
+export class BatchValidatorComponent {
+  inputEans = signal('');
+  results = signal<ValidationResult[]>([]);
+
+  validCount = signal(0);
+
+  validate(): void {
+    const eans = this.inputEans()
+      .split('\n')
+      .map(line => line.trim())
+      .filter(line => line.length > 0);
+
+    const results: ValidationResult[] = eans.map(ean => ({
+      ean,
+      valid: isEan(ean)
+    }));
+
+    this.results.set(results);
+    this.validCount.set(results.filter(r => r.valid).length);
+  }
+}
+```
+
+### Dynamic Form with Multiple EANs
+
+```typescript
+import { Component } from '@angular/core';
+import { FormArray, FormControl, FormGroup, ReactiveFormsModule } from '@angular/forms';
+import { eanValidator } from '@isa/utils/ean-validation';
+
+@Component({
+  selector: 'app-multi-ean-form',
+  standalone: true,
+  imports: [ReactiveFormsModule],
+  template: `
+    <form [formGroup]="form" (ngSubmit)="onSubmit()">
+      <h3>Product EANs</h3>
+
+      <div formArrayName="eans">
+        @for (control of eanControls.controls; track $index) {
+          <div class="ean-field">
+            <input
+              [formControlName]="$index"
+              type="text"
+              maxlength="13"
+              placeholder="1234567890123"
+            />
+
+            @if (control.touched && control.errors?.['invalidEan']) {
+              <span class="error">Invalid EAN</span>
+            }
+
+            <button type="button" (click)="removeEan($index)">
+              Remove
+            </button>
+          </div>
+        }
+      </div>
+
+      <button type="button" (click)="addEan()">
+        Add EAN
+      </button>
+
+      <button type="submit" [disabled]="!form.valid">
+        Save
+      </button>
+    </form>
+  `
+})
+export class MultiEanFormComponent {
+  form = new FormGroup({
+    eans: new FormArray([
+      new FormControl('', [eanValidator])
+    ])
+  });
+
+  get eanControls() {
+    return this.form.get('eans') as FormArray;
+  }
+
+  addEan(): void {
+    this.eanControls.push(
+      new FormControl('', [eanValidator])
+    );
+  }
+
+  removeEan(index: number): void {
+    this.eanControls.removeAt(index);
+  }
+
+  onSubmit(): void {
+    if (this.form.valid) {
+      const eans = this.eanControls.value;
+      console.log('Saving EANs:', eans);
+    }
+  }
+}
+```
+
+### Type Guard Usage
+
+```typescript
+import { Component } from '@angular/core';
+import { isEan } from '@isa/utils/ean-validation';
+
+interface Product {
+  id: number;
+  name: string;
+  ean?: string; // Optional EAN
+}
+
+@Component({
+  selector: 'app-product-list',
+  template: `
+    <div class="products">
+      @for (product of products; track product.id) {
+        <div class="product">
+          <h3>{{ product.name }}</h3>
+
+          @if (hasValidEan(product)) {
+            <p>EAN: {{ product.ean }}</p>
+          } @else {
+            <p class="warning">No valid EAN</p>
+          }
+        </div>
+      }
+    </div>
+  `
+})
+export class ProductListComponent {
+  products: Product[] = [
+    { id: 1, name: 'Product A', ean: '1234567890123' },
+    { id: 2, name: 'Product B', ean: '123' }, // Invalid
+    { id: 3, name: 'Product C' }, // Missing
+  ];
+
+  hasValidEan(product: Product): boolean {
+    return isEan(product.ean);
+  }
+}
+```
+
+## EAN Format
+
+### Standard Format
+
+**EAN-13 Structure:**
+```
+┌──────────────────────────────────┐
+│     1  2  3  4  5  6  7  8  9  0  1  2  3     │
+│     └──┬──┘  └───────┬────────┘  │     │     │
+│        │             │            │     │     │
+│     Prefix      Manufacturer    Product Check │
+│                  Code            Code   Digit │
+└──────────────────────────────────┘
+```
+
+### Common Prefixes
+
+| Prefix | Region/Type |
+|--------|-------------|
+| 000-019 | GS1 US |
+| 020-029 | Restricted distribution |
+| 030-039 | GS1 US |
+| 040-049 | Restricted distribution |
+| 050-059 | GS1 US reserved |
+| 060-139 | GS1 US |
+| 200-299 | Restricted distribution |
+| 300-379 | GS1 France |
+| 380 | GS1 Bulgaria |
+| 383 | GS1 Slovenia |
+| 385 | GS1 Croatia |
+| 400-440 | GS1 Germany |
+| 450-459, 490-499 | GS1 Japan |
+| 460-469 | GS1 Russia |
+| 470 | GS1 Kyrgyzstan |
+| 471 | GS1 Taiwan |
+| 474 | GS1 Estonia |
+| 475 | GS1 Latvia |
+| 476 | GS1 Azerbaijan |
+| 477 | GS1 Lithuania |
+| 478 | GS1 Uzbekistan |
+| 479 | GS1 Sri Lanka |
+| 480 | GS1 Philippines |
+| 481 | GS1 Belarus |
+| 482 | GS1 Ukraine |
+| 484 | GS1 Moldova |
+| 485 | GS1 Armenia |
+| 486 | GS1 Georgia |
+| 487 | GS1 Kazakhstan |
+| 489 | GS1 Hong Kong |
+| 500-509 | GS1 UK |
+| 520-521 | GS1 Association Greece |
+| 528 | GS1 Lebanon |
+| 529 | GS1 Cyprus |
+| 530 | GS1 Albania |
+| 531 | GS1 Macedonia |
+| 535 | GS1 Malta |
+| 539 | GS1 Ireland |
+| 540-549 | GS1 Belgium & Luxembourg |
+| 560 | GS1 Portugal |
+| 569 | GS1 Iceland |
+| 570-579 | GS1 Denmark |
+| 590 | GS1 Poland |
+| 594 | GS1 Romania |
+| 599 | GS1 Hungary |
+| 600-601 | GS1 South Africa |
+| 603 | GS1 Ghana |
+| 604 | GS1 Senegal |
+| 608 | GS1 Bahrain |
+| 609 | GS1 Mauritius |
+| 611 | GS1 Morocco |
+| 613 | GS1 Algeria |
+| 615 | GS1 Nigeria |
+| 616 | GS1 Kenya |
+| 618 | GS1 Ivory Coast |
+| 619 | GS1 Tunisia |
+| 620 | GS1 Tanzania |
+| 621 | GS1 Syria |
+| 622 | GS1 Egypt |
+| 623 | GS1 Brunei |
+| 624 | GS1 Libya |
+| 625 | GS1 Jordan |
+| 626 | GS1 Iran |
+| 627 | GS1 Kuwait |
+| 628 | GS1 Saudi Arabia |
+| 629 | GS1 Emirates |
+| 640-649 | GS1 Finland |
+| 690-699 | GS1 China |
+| 700-709 | GS1 Norway |
+| 729 | GS1 Israel |
+| 730-739 | GS1 Sweden |
+| 740 | GS1 Guatemala |
+| 741 | GS1 El Salvador |
+| 742 | GS1 Honduras |
+| 743 | GS1 Nicaragua |
+| 744 | GS1 Costa Rica |
+| 745 | GS1 Panama |
+| 746 | GS1 Dominican Republic |
+| 750 | GS1 Mexico |
+| 754-755 | GS1 Canada |
+| 759 | GS1 Venezuela |
+| 760-769 | GS1 Switzerland |
+| 770-771 | GS1 Colombia |
+| 773 | GS1 Uruguay |
+| 775 | GS1 Peru |
+| 777 | GS1 Bolivia |
+| 778-779 | GS1 Argentina |
+| 780 | GS1 Chile |
+| 784 | GS1 Paraguay |
+| 786 | GS1 Ecuador |
+| 789-790 | GS1 Brazil |
+| 800-839 | GS1 Italy |
+| 840-849 | GS1 Spain |
+| 850 | GS1 Cuba |
+| 858 | GS1 Slovakia |
+| 859 | GS1 Czech |
+| 860 | GS1 Serbia |
+| 865 | GS1 Mongolia |
+| 867 | GS1 North Korea |
+| 868-869 | GS1 Turkey |
+| 870-879 | GS1 Netherlands |
+| 880 | GS1 South Korea |
+| 884 | GS1 Cambodia |
+| 885 | GS1 Thailand |
+| 888 | GS1 Singapore |
+| 890 | GS1 India |
+| 893 | GS1 Vietnam |
+| 896 | GS1 Pakistan |
+| 899 | GS1 Indonesia |
+| 900-919 | GS1 Austria |
+| 930-939 | GS1 Australia |
+| 940-949 | GS1 New Zealand |
+| 950 | GS1 Global Office |
+| 951 | GS1 Global Office (EPCglobal) |
+| 955 | GS1 Malaysia |
+| 958 | GS1 Macau |
+| 960-969 | GS1 Global Office (GTIN-8) |
+| 977 | Serial publications (ISSN) |
+| 978-979 | Bookland (ISBN) |
+| 980 | Refund receipts |
+| 981-984 | GS1 coupon identification |
+| 990-999 | GS1 coupon identification |
+
+**Note:** This library validates format only (13 digits), not check digit accuracy or prefix validity.
+
+## Architecture Notes
+
+### Design Patterns
+
+#### Validator Function Pattern
+
+The `eanValidator` follows Angular's `ValidatorFn` pattern:
+
+```typescript
+export const eanValidator: ValidatorFn = (
+  control: AbstractControl
+): ValidationErrors | null => {
+  const value = control.value;
+  if (value && !EAN_REGEX.test(value)) {
+    return { invalidEan: true };
+  }
+  return null;
+};
+```
+
+**Benefits:**
+- Composable with other validators
+- Reusable across multiple form controls
+- Type-safe with TypeScript
+- Follows Angular conventions
+
+#### Pure Function Pattern
+
+The `isEan` function is a pure function with no side effects:
+
+```typescript
+export const isEan = (value: string | undefined): boolean => {
+  if (!value) {
+    return false;
+  }
+  return EAN_REGEX.test(value);
+};
+```
+
+**Benefits:**
+- Predictable - same input always produces same output
+- Testable - easy to unit test
+- Framework agnostic - can be used outside Angular
+- No dependencies - doesn't rely on external state
+
+### Performance Considerations
+
+1. **Regex Performance** - Simple regex pattern for O(n) validation
+2. **No External Dependencies** - Minimal bundle size impact
+3. **Null-Safe** - Early returns for undefined/null values
+4. **Reusable Regex** - Single compiled regex constant
+
+### Future Enhancements
+
+Potential improvements identified:
+
+1. **Check Digit Validation** - Validate the EAN-13 check digit algorithm
+2. **EAN-8 Support** - Support for 8-digit EAN format
+3. **UPC Support** - Support for 12-digit UPC format
+4. **Prefix Validation** - Validate GS1 country/region prefixes
+5. **Format Conversion** - Convert between EAN-13, EAN-8, and UPC
+6. **Barcode Generation** - Generate barcode images from EAN
+7. **Async Validation** - Validate against product database
+
+## Testing
+
+The library uses **Vitest** with **Angular Testing Utilities** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test ean-validation --skip-nx-cache
+
+# Run tests with coverage
+npx nx test ean-validation --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test ean-validation --watch
+```
+
+### Test Structure
+
+The library includes comprehensive unit tests covering:
+
+- **eanValidator Tests**:
+  - Valid 13-digit EAN returns null
+  - Empty value returns null (valid)
+  - Invalid EAN returns error object
+  - Null/undefined values handled correctly
+
+- **isEan Tests**:
+  - Valid 13-digit EAN returns true
+  - Invalid EAN returns false
+  - Empty string returns false
+  - Undefined returns false
+
+### Example Test
+
+```typescript
+import { describe, it, expect } from 'vitest';
+import { FormControl } from '@angular/forms';
+import { eanValidator, isEan } from './ean-validation';
+
+describe('eanValidator', () => {
+  it('should return null for valid EAN', () => {
+    // Arrange
+    const control = new FormControl('1234567890123');
+
+    // Act
+    const result = eanValidator(control);
+
+    // Assert
+    expect(result).toBeNull();
+  });
+
+  it('should return null for empty value', () => {
+    // Arrange
+    const control = new FormControl('');
+
+    // Act
+    const result = eanValidator(control);
+
+    // Assert
+    expect(result).toBeNull();
+  });
+
+  it('should return error for invalid EAN', () => {
+    // Arrange
+    const control = new FormControl('123');
+
+    // Act
+    const result = eanValidator(control);
+
+    // Assert
+    expect(result).toEqual({ invalidEan: true });
+  });
+});
+
+describe('isEan', () => {
+  it('should return true for valid EAN', () => {
+    // Arrange
+    const validEan = '1234567890123';
+
+    // Act
+    const result = isEan(validEan);
+
+    // Assert
+    expect(result).toBe(true);
+  });
+
+  it('should return false for undefined value', () => {
+    // Arrange
+    const undefinedValue = undefined;
+
+    // Act
+    const result = isEan(undefinedValue);
+
+    // Assert
+    expect(result).toBe(false);
+  });
+
+  it('should return false for invalid EAN', () => {
+    // Arrange
+    const invalidEan = '123';
+
+    // Act
+    const result = isEan(invalidEan);
+
+    // Assert
+    expect(result).toBe(false);
+  });
+});
+```
+
+## Dependencies
+
+### Required Libraries
+
+- `@angular/core` - For TypeScript types
+- `@angular/forms` - For `ValidatorFn`, `AbstractControl`, `ValidationErrors` types
+
+### Path Alias
+
+Import from: `@isa/utils/ean-validation`
+
+### Exports
+
+- `eanValidator` - Angular Forms validator function
+- `isEan` - Standalone validation utility function
+- `EAN_REGEX` - Regular expression constant (internal use)
+
+## Best Practices
+
+### 1. Use with Validators.required
+
+Combine with `Validators.required` for required fields:
+
+```typescript
+// Good - Required + EAN validation
+const eanControl = new FormControl('', [
+  Validators.required,
+  eanValidator
+]);
+
+// Avoid - Only EAN validation (allows empty)
+const eanControl = new FormControl('', [eanValidator]);
+```
+
+### 2. Provide Clear Error Messages
+
+Show user-friendly error messages:
+
+```typescript
+// Good - Clear, actionable error message
+@if (ean.errors?.['invalidEan']) {
+  <p class="error">
+    Please enter a valid 13-digit EAN (e.g., 1234567890123)
+  </p>
+}
+
+// Avoid - Generic or unclear message
+@if (ean.errors?.['invalidEan']) {
+  <p class="error">Invalid</p>
+}
+```
+
+### 3. Use isEan for Type Guards
+
+Use `isEan()` for runtime type checking:
+
+```typescript
+// Good - Type-safe validation
+function processEan(code: string | undefined): void {
+  if (isEan(code)) {
+    // TypeScript knows code is string here
+    console.log('Processing:', code.toUpperCase());
+  }
+}
+
+// Avoid - Unsafe type assumption
+function processEan(code: string): void {
+  // Might throw if code is invalid
+  console.log('Processing:', code.toUpperCase());
+}
+```
+
+### 4. Add Maxlength Attribute
+
+Prevent users from entering more than 13 digits:
+
+```typescript
+// Good - Limit input length
+<input
+  formControlName="ean"
+  type="text"
+  maxlength="13"
+  placeholder="1234567890123"
+/>
+
+// Avoid - No length restriction
+<input
+  formControlName="ean"
+  type="text"
+/>
+```
+
+### 5. Handle Validation in Components
+
+Keep validation logic in components, not templates:
+
+```typescript
+// Good - Logic in component
+canSubmit(): boolean {
+  return this.form.valid && isEan(this.form.value.ean);
+}
+
+// Avoid - Complex logic in template
+@if (form.valid && form.value.ean && /^[0-9]{13}$/.test(form.value.ean)) {
+  ...
+}
+```
+
+## Limitations
+
+### What This Library Does NOT Do
+
+1. **Check Digit Validation** - Does not validate the EAN-13 checksum digit
+2. **Database Validation** - Does not verify if EAN exists in product database
+3. **Prefix Validation** - Does not validate GS1 country/region prefixes
+4. **Format Conversion** - Does not convert between EAN/UPC formats
+5. **Barcode Generation** - Does not generate barcode images
+
+### When to Use Additional Validation
+
+For production systems, consider:
+
+- **Check digit validation** for data integrity
+- **Database lookup** for product existence
+- **Prefix validation** for regional compliance
+- **Duplicate detection** in batch processing
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/libs/utils/z-safe-parse/README.md b/libs/utils/z-safe-parse/README.md
index 74349ce8e..45ca1aeec 100644
--- a/libs/utils/z-safe-parse/README.md
+++ b/libs/utils/z-safe-parse/README.md
@@ -1,7 +1,923 @@
-# utils-z-safe-parse
+# @isa/utils/z-safe-parse
 
-This library was generated with [Nx](https://nx.dev).
+A lightweight Zod utility library for safe parsing with automatic fallback to original values on validation failures.
 
-## Running unit tests
+## Overview
 
-Run `nx test utils-z-safe-parse` to execute the unit tests.
+The Z-Safe-Parse library provides a single utility function `safeParse()` that wraps Zod's `safeParse()` method to provide graceful error handling. Unlike Zod's standard parsing which throws errors on validation failures, this utility automatically falls back to the original input value and logs a warning to the console. This makes it ideal for scenarios where you want to validate data transformations but maintain application stability even when validation fails.
+
+## Table of Contents
+
+- [Features](#features)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [API Reference](#api-reference)
+- [Usage Examples](#usage-examples)
+- [Error Handling](#error-handling)
+- [Best Practices](#best-practices)
+- [Testing](#testing)
+- [Architecture Notes](#architecture-notes)
+
+## Features
+
+- **Safe parsing** - Never throws errors, always returns a value
+- **Automatic fallback** - Returns original input when validation fails
+- **Console warnings** - Logs validation errors for debugging
+- **Type-safe** - Full TypeScript type inference from Zod schemas
+- **Lightweight** - Single utility function with minimal dependencies
+- **Zod integration** - Works seamlessly with existing Zod schemas
+- **Zero configuration** - Drop-in replacement for Zod's parse method
+
+## Quick Start
+
+### 1. Import the Utility
+
+```typescript
+import { safeParse } from '@isa/utils/z-safe-parse';
+import { z } from 'zod';
+```
+
+### 2. Define a Zod Schema
+
+```typescript
+const UserSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  email: z.string().email(),
+});
+
+type User = z.infer<typeof UserSchema>;
+```
+
+### 3. Parse Data Safely
+
+```typescript
+// Valid data - parses successfully
+const validUser = safeParse(UserSchema, {
+  id: 1,
+  name: 'John Doe',
+  email: 'john@example.com'
+});
+// Result: { id: 1, name: 'John Doe', email: 'john@example.com' }
+
+// Invalid data - returns original input and logs warning
+const invalidUser = safeParse(UserSchema, {
+  id: '1',           // Wrong type (should be number)
+  name: 'Jane Doe',
+  email: 'invalid'   // Invalid email format
+});
+// Result: { id: '1', name: 'Jane Doe', email: 'invalid' } (original input)
+// Console: Warning logged with Zod error details
+```
+
+## Core Concepts
+
+### Safe Parsing Philosophy
+
+The `safeParse()` function follows a non-throwing error handling philosophy:
+
+```typescript
+// Traditional Zod parsing (throws on error)
+try {
+  const data = UserSchema.parse(input);
+  // Use data...
+} catch (error) {
+  // Handle error...
+  console.error('Validation failed:', error);
+}
+
+// Safe parsing (never throws)
+const data = safeParse(UserSchema, input);
+// Always get a value back (validated or original)
+// Errors automatically logged to console
+```
+
+### Type Inference
+
+Full TypeScript type inference is maintained:
+
+```typescript
+const UserSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+});
+
+// TypeScript infers return type as:
+// { id: number; name: string }
+const user = safeParse(UserSchema, input);
+```
+
+**Important**: Due to fallback behavior, the actual runtime type might not match the inferred type if validation fails. Use this utility only when you can tolerate type mismatches or have additional type guards.
+
+### Console Warning Output
+
+When validation fails, a warning is logged with full error details:
+
+```typescript
+safeParse(UserSchema, { id: 'invalid', name: 123 });
+
+// Console output:
+// Warning: Failed to parse data
+// ZodError: [
+//   {
+//     "code": "invalid_type",
+//     "expected": "number",
+//     "received": "string",
+//     "path": ["id"],
+//     "message": "Expected number, received string"
+//   },
+//   {
+//     "code": "invalid_type",
+//     "expected": "string",
+//     "received": "number",
+//     "path": ["name"],
+//     "message": "Expected string, received number"
+//   }
+// ]
+```
+
+### Use Case Scenarios
+
+**Ideal for**:
+- Parsing external API responses where validation failures should not crash the app
+- Data migrations where you want to log issues but maintain compatibility
+- Form data transformations with lenient error handling
+- Development/debugging scenarios where you want to see invalid data
+
+**Not ideal for**:
+- Critical data validation where failures must halt execution
+- Security-sensitive parsing where invalid data is dangerous
+- Type-strict contexts where runtime type mismatches cause downstream errors
+
+## API Reference
+
+### `safeParse<T>(schema, data): T`
+
+Safely parses data using a Zod schema, returning validated data on success or original data on failure.
+
+#### Parameters
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `schema` | `z.ZodSchema<T>` | Zod schema to validate against |
+| `data` | `unknown` | Data to parse and validate |
+
+#### Returns
+
+`T` - Validated data if parsing succeeds, otherwise the original input cast to `T`
+
+#### Type Parameters
+
+- `T` - The TypeScript type inferred from the Zod schema
+
+#### Side Effects
+
+- Logs warning to console if parsing fails (includes full Zod error)
+
+#### Example
+
+```typescript
+import { safeParse } from '@isa/utils/z-safe-parse';
+import { z } from 'zod';
+
+const ProductSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  price: z.number().positive(),
+  inStock: z.boolean()
+});
+
+type Product = z.infer<typeof ProductSchema>;
+
+// Success case
+const product: Product = safeParse(ProductSchema, {
+  id: 42,
+  name: 'Widget',
+  price: 19.99,
+  inStock: true
+});
+
+console.log(product.id); // 42 (type-safe)
+
+// Failure case
+const invalidProduct: Product = safeParse(ProductSchema, {
+  id: '42',      // Wrong type
+  name: 'Widget',
+  price: -10,    // Negative price
+  inStock: 'yes' // Wrong type
+});
+
+// Warning logged to console
+// Returns: { id: '42', name: 'Widget', price: -10, inStock: 'yes' }
+// Note: TypeScript type is Product, but runtime type doesn't match!
+```
+
+## Usage Examples
+
+### API Response Parsing
+
+```typescript
+import { safeParse } from '@isa/utils/z-safe-parse';
+import { z } from 'zod';
+import { HttpClient } from '@angular/common/http';
+
+const ApiResponseSchema = z.object({
+  data: z.array(z.object({
+    id: z.number(),
+    title: z.string(),
+    createdAt: z.string().datetime()
+  })),
+  total: z.number(),
+  page: z.number()
+});
+
+type ApiResponse = z.infer<typeof ApiResponseSchema>;
+
+@Injectable()
+export class DataService {
+  #http = inject(HttpClient);
+
+  async fetchData(): Promise<ApiResponse> {
+    const response = await fetch('/api/data');
+    const json = await response.json();
+
+    // Safe parse - won't throw even if API response is malformed
+    return safeParse(ApiResponseSchema, json);
+  }
+}
+```
+
+### Form Data Transformation
+
+```typescript
+import { safeParse } from '@isa/utils/z-safe-parse';
+import { z } from 'zod';
+
+const FormDataSchema = z.object({
+  name: z.string().min(1),
+  age: z.coerce.number().int().positive(),
+  email: z.string().email(),
+  agreeToTerms: z.boolean()
+});
+
+type FormData = z.infer<typeof FormDataSchema>;
+
+function processFormSubmission(rawFormData: unknown): FormData {
+  // Parse form data with automatic type coercion
+  const formData = safeParse(FormDataSchema, rawFormData);
+
+  // If validation failed, formData contains original (possibly invalid) data
+  // but function continues execution
+  console.log('Processing form:', formData);
+
+  return formData;
+}
+
+// Example usage
+const submittedData = {
+  name: 'John',
+  age: '25',       // String, will be coerced to number
+  email: 'john@example.com',
+  agreeToTerms: true
+};
+
+const result = processFormSubmission(submittedData);
+// Success: { name: 'John', age: 25, email: 'john@example.com', agreeToTerms: true }
+```
+
+### Data Migration with Logging
+
+```typescript
+import { safeParse } from '@isa/utils/z-safe-parse';
+import { z } from 'zod';
+
+// Old data format
+interface LegacyUser {
+  user_id: string;
+  user_name: string;
+  user_email: string;
+}
+
+// New data format
+const ModernUserSchema = z.object({
+  id: z.coerce.number(),
+  name: z.string(),
+  email: z.string().email()
+});
+
+type ModernUser = z.infer<typeof ModernUserSchema>;
+
+function migrateLegacyUsers(legacyUsers: LegacyUser[]): ModernUser[] {
+  return legacyUsers.map(legacy => {
+    // Transform to new format
+    const transformed = {
+      id: legacy.user_id,
+      name: legacy.user_name,
+      email: legacy.user_email
+    };
+
+    // Safe parse - logs warnings for invalid data but continues migration
+    return safeParse(ModernUserSchema, transformed);
+  });
+}
+
+// Example usage
+const legacyData: LegacyUser[] = [
+  { user_id: '1', user_name: 'Alice', user_email: 'alice@example.com' },
+  { user_id: 'invalid', user_name: 'Bob', user_email: 'not-an-email' } // Invalid!
+];
+
+const migratedUsers = migrateLegacyUsers(legacyData);
+// Migrates all users, logs warnings for invalid entries
+// Result: [
+//   { id: 1, name: 'Alice', email: 'alice@example.com' }, // Valid
+//   { id: 'invalid', name: 'Bob', email: 'not-an-email' } // Invalid, logged
+// ]
+```
+
+### Configuration File Parsing
+
+```typescript
+import { safeParse } from '@isa/utils/z-safe-parse';
+import { z } from 'zod';
+
+const ConfigSchema = z.object({
+  apiUrl: z.string().url(),
+  timeout: z.number().int().positive().default(5000),
+  retries: z.number().int().nonnegative().default(3),
+  debug: z.boolean().default(false)
+});
+
+type Config = z.infer<typeof ConfigSchema>;
+
+function loadConfig(configFile: unknown): Config {
+  // Parse config with defaults and validation
+  const config = safeParse(ConfigSchema, configFile);
+
+  // Even if validation fails, app continues with original values
+  // (might have missing required fields!)
+  return config;
+}
+
+// Example usage
+const userConfig = {
+  apiUrl: 'https://api.example.com',
+  timeout: '10000', // String, will be coerced to number
+  // retries: omitted, will use default
+  debug: true
+};
+
+const config = loadConfig(userConfig);
+console.log(config.timeout); // 10000 (coerced from string)
+console.log(config.retries);  // 3 (default value)
+```
+
+### Array Validation with Filtering
+
+```typescript
+import { safeParse } from '@isa/utils/z-safe-parse';
+import { z } from 'zod';
+
+const ItemSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  price: z.number().positive()
+});
+
+const ItemsArraySchema = z.array(ItemSchema);
+
+type Item = z.infer<typeof ItemSchema>;
+
+function parseItemsArray(data: unknown): Item[] {
+  // Parse array - if validation fails, returns original array
+  const items = safeParse(ItemsArraySchema, data);
+
+  // Additional runtime validation (since safeParse might return invalid data)
+  return items.filter((item: any) => {
+    return typeof item.id === 'number' &&
+           typeof item.name === 'string' &&
+           typeof item.price === 'number' &&
+           item.price > 0;
+  });
+}
+
+// Example usage
+const mixedData = [
+  { id: 1, name: 'Item 1', price: 10.00 },   // Valid
+  { id: '2', name: 'Item 2', price: 20.00 }, // Invalid id type
+  { id: 3, name: 'Item 3', price: -5 },      // Invalid price
+  { id: 4, name: 'Item 4', price: 15.00 }    // Valid
+];
+
+const validItems = parseItemsArray(mixedData);
+// Result: Only items 1 and 4 (valid items after filtering)
+// Console: Warning logged for validation failure
+```
+
+### Optional Field Handling
+
+```typescript
+import { safeParse } from '@isa/utils/z-safe-parse';
+import { z } from 'zod';
+
+const UserProfileSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  bio: z.string().optional(),
+  website: z.string().url().optional(),
+  age: z.number().int().positive().optional()
+});
+
+type UserProfile = z.infer<typeof UserProfileSchema>;
+
+function parseUserProfile(data: unknown): UserProfile {
+  return safeParse(UserProfileSchema, data);
+}
+
+// Example usage
+const profile1 = parseUserProfile({
+  id: 1,
+  name: 'John',
+  bio: 'Software developer',
+  // website omitted - valid (optional)
+  age: 30
+});
+// Success: All optional fields handled correctly
+
+const profile2 = parseUserProfile({
+  id: '2',        // Wrong type
+  name: 'Jane',
+  website: 'not-a-url' // Invalid URL
+});
+// Warning logged, returns original data
+```
+
+## Error Handling
+
+### Console Warning Format
+
+When validation fails, `safeParse()` logs a warning with this format:
+
+```
+console.warn('Failed to parse data', zodError);
+```
+
+The `zodError` object contains:
+- **issues**: Array of validation errors
+- **path**: Path to the failing field
+- **message**: Human-readable error message
+- **code**: Error code (e.g., 'invalid_type', 'too_small')
+
+### Detecting Parse Failures
+
+Since `safeParse()` always returns a value, you cannot rely on try/catch. To detect failures:
+
+#### Option 1: Use Zod's safeParse directly
+
+```typescript
+const result = UserSchema.safeParse(data);
+
+if (!result.success) {
+  // Handle validation failure
+  console.error('Validation failed:', result.error);
+  // Use original data or default value
+  return data as User;
+} else {
+  // Use validated data
+  return result.data;
+}
+```
+
+#### Option 2: Add runtime type guards
+
+```typescript
+const user = safeParse(UserSchema, data);
+
+// Runtime check
+if (typeof user.id !== 'number') {
+  // Validation likely failed
+  console.error('Invalid user data, using defaults');
+  return getDefaultUser();
+}
+
+return user;
+```
+
+#### Option 3: Combine with validation flag
+
+```typescript
+function parseWithValidation<T>(
+  schema: z.ZodSchema<T>,
+  data: unknown
+): { data: T; isValid: boolean } {
+  const result = schema.safeParse(data);
+
+  if (result.success) {
+    return { data: result.data, isValid: true };
+  } else {
+    console.warn('Failed to parse data', result.error);
+    return { data: data as T, isValid: false };
+  }
+}
+
+// Usage
+const { data, isValid } = parseWithValidation(UserSchema, input);
+
+if (!isValid) {
+  // Handle invalid data
+  return getDefaultUser();
+}
+
+return data;
+```
+
+### Production Considerations
+
+For production environments, consider:
+
+1. **Custom logging** - Replace `console.warn` with proper logging service
+2. **Error tracking** - Send validation errors to error tracking (Sentry, etc.)
+3. **Metrics** - Track validation failure rates
+4. **Alerts** - Alert on high validation failure rates
+
+```typescript
+// Production-ready wrapper
+import { safeParse as baseSafeParse } from '@isa/utils/z-safe-parse';
+import { z } from 'zod';
+import { LoggingService } from '@isa/core/logging';
+
+export function safeParse<T>(
+  schema: z.ZodSchema<T>,
+  data: unknown,
+  context?: string
+): T {
+  const result = schema.safeParse(data);
+
+  if (!result.success) {
+    // Log to proper logging service
+    inject(LoggingService).warn('Validation failed', {
+      context,
+      error: result.error,
+      data
+    });
+
+    // Track metrics
+    trackValidationFailure(schema, context);
+  }
+
+  return result.success ? result.data : (data as T);
+}
+```
+
+## Best Practices
+
+### When to Use safeParse()
+
+**Use safeParse() when**:
+- Parsing external data that might be malformed
+- Development/debugging to see invalid data
+- Data migrations where errors should be logged but not halt execution
+- Lenient form validation where UX requires showing original input
+
+**Don't use safeParse() when**:
+- Validation failure should stop execution
+- Type safety is critical for downstream code
+- Security-sensitive data parsing
+- You need to differentiate between valid and invalid data programmatically
+
+### Type Safety Considerations
+
+```typescript
+// Risky - runtime type might not match TypeScript type
+const user: User = safeParse(UserSchema, input);
+user.id.toFixed(2); // Might fail if id is actually a string!
+
+// Safer - add runtime guards
+const user = safeParse(UserSchema, input);
+if (typeof user.id === 'number') {
+  user.id.toFixed(2); // Safe
+}
+
+// Safest - use Zod's safeParse directly for critical paths
+const result = UserSchema.safeParse(input);
+if (result.success) {
+  result.data.id.toFixed(2); // Type-safe
+}
+```
+
+### Logging Best Practices
+
+```typescript
+// Bad - Silent failures
+const data = safeParse(schema, input);
+// No way to know if parsing failed!
+
+// Good - Check console for warnings during development
+const data = safeParse(schema, input);
+// Warnings appear in console during development
+
+// Better - Use proper logging in production
+const result = schema.safeParse(input);
+if (!result.success) {
+  logger.warn('Validation failed', { error: result.error, input });
+}
+return result.success ? result.data : (input as T);
+```
+
+### Schema Design
+
+Design schemas to be lenient when using safeParse():
+
+```typescript
+// Too strict - many false negatives
+const StrictSchema = z.object({
+  id: z.number(),
+  name: z.string().min(1).max(50),
+  email: z.string().email(),
+  age: z.number().int().min(18).max(120)
+});
+
+// More lenient - graceful degradation
+const LenientSchema = z.object({
+  id: z.coerce.number(),           // Coerce from string
+  name: z.string().default(''),    // Default for missing values
+  email: z.string().optional(),    // Optional instead of required
+  age: z.coerce.number().optional() // Coerce + optional
+});
+```
+
+### Combining with Other Validation
+
+```typescript
+import { safeParse } from '@isa/utils/z-safe-parse';
+
+// Zod for structure validation
+const UserSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  email: z.string()
+});
+
+// Custom business logic validation
+function validateUserBusinessRules(user: User): boolean {
+  // Check business rules that Zod can't express
+  return user.name !== 'admin' && user.email.includes('@');
+}
+
+// Combined validation
+function parseAndValidateUser(data: unknown): User | null {
+  const user = safeParse(UserSchema, data);
+
+  if (!validateUserBusinessRules(user)) {
+    console.error('Business validation failed');
+    return null;
+  }
+
+  return user;
+}
+```
+
+## Testing
+
+The library uses **Jest** for testing.
+
+### Running Tests
+
+```bash
+# Run tests for this library
+npx nx test utils-z-safe-parse --skip-nx-cache
+
+# Run tests with coverage
+npx nx test utils-z-safe-parse --code-coverage --skip-nx-cache
+
+# Run tests in watch mode
+npx nx test utils-z-safe-parse --watch
+```
+
+### Test Examples
+
+```typescript
+import { describe, it, expect, vi } from '@jest/globals';
+import { safeParse } from './utils-z-safe-parse';
+import { z } from 'zod';
+
+describe('safeParse', () => {
+  const TestSchema = z.object({
+    id: z.number(),
+    name: z.string()
+  });
+
+  it('should return parsed data for valid input', () => {
+    const input = { id: 1, name: 'Test' };
+    const result = safeParse(TestSchema, input);
+
+    expect(result).toEqual(input);
+  });
+
+  it('should return original data for invalid input', () => {
+    const input = { id: 'invalid', name: 123 };
+    const result = safeParse(TestSchema, input);
+
+    expect(result).toEqual(input);
+  });
+
+  it('should log warning for invalid input', () => {
+    const consoleWarnSpy = vi.spyOn(console, 'warn').mockImplementation();
+
+    const input = { id: 'invalid', name: 'Test' };
+    safeParse(TestSchema, input);
+
+    expect(consoleWarnSpy).toHaveBeenCalledWith(
+      'Failed to parse data',
+      expect.any(Object)
+    );
+
+    consoleWarnSpy.mockRestore();
+  });
+
+  it('should handle complex nested schemas', () => {
+    const NestedSchema = z.object({
+      user: z.object({
+        id: z.number(),
+        profile: z.object({
+          name: z.string(),
+          age: z.number()
+        })
+      })
+    });
+
+    const validInput = {
+      user: {
+        id: 1,
+        profile: { name: 'John', age: 30 }
+      }
+    };
+
+    const result = safeParse(NestedSchema, validInput);
+    expect(result).toEqual(validInput);
+  });
+
+  it('should preserve type coercion', () => {
+    const CoerceSchema = z.object({
+      id: z.coerce.number(),
+      active: z.coerce.boolean()
+    });
+
+    const input = { id: '42', active: 'true' };
+    const result = safeParse(CoerceSchema, input);
+
+    expect(result.id).toBe(42);
+    expect(result.active).toBe(true);
+  });
+});
+```
+
+## Architecture Notes
+
+### Implementation Details
+
+The `safeParse()` function is a thin wrapper around Zod's `safeParse()` method:
+
+```typescript
+export function safeParse<T>(schema: z.ZodSchema<T>, data: unknown): T {
+  const parsed = schema.safeParse(data);
+
+  if (!parsed.success) {
+    console.warn('Failed to parse data', parsed.error);
+    return data as T;
+  }
+
+  return parsed.data;
+}
+```
+
+**Key characteristics**:
+1. **Single responsibility** - Only handles safe parsing with fallback
+2. **Zero configuration** - Works out of the box
+3. **Type preservation** - Maintains TypeScript types from schema
+4. **Non-throwing** - Always returns a value
+5. **Logging only** - Side effect limited to console.warn
+
+### Design Decisions
+
+#### 1. Fallback to Original Value
+
+**Decision**: Return original input when validation fails
+
+**Rationale**:
+- Maintains application stability
+- Allows graceful degradation
+- Useful for development/debugging
+
+**Tradeoff**: Type safety is compromised (TypeScript type might not match runtime type)
+
+#### 2. Console Warning
+
+**Decision**: Log to console.warn instead of console.error
+
+**Rationale**:
+- Warning severity (not critical error)
+- Easy to find in browser dev tools
+- Doesn't trigger error tracking by default
+
+**Tradeoff**: May be missed in production without proper monitoring
+
+#### 3. No Success Flag
+
+**Decision**: Don't return a success boolean with the result
+
+**Rationale**:
+- Simpler API (just returns T)
+- Encourages graceful handling
+- Keeps wrapper minimal
+
+**Tradeoff**: Can't programmatically detect failures without runtime checks
+
+### Comparison with Alternatives
+
+#### vs. Zod's parse()
+
+```typescript
+// Zod's parse() - throws on error
+try {
+  const data = UserSchema.parse(input);
+} catch (error) {
+  // Handle error
+}
+
+// safeParse() - never throws
+const data = safeParse(UserSchema, input);
+// Warning logged if invalid
+```
+
+#### vs. Zod's safeParse()
+
+```typescript
+// Zod's safeParse() - returns result object
+const result = UserSchema.safeParse(input);
+if (result.success) {
+  // Use result.data
+} else {
+  // Handle result.error
+}
+
+// safeParse() - always returns data
+const data = safeParse(UserSchema, input);
+// Original data if validation fails
+```
+
+### Known Limitations
+
+#### 1. Type Safety Compromise (High Impact)
+
+**Limitation**: Runtime type might not match TypeScript type
+
+**Impact**: High - can cause runtime errors in downstream code
+
+**Mitigation**:
+- Add runtime type guards for critical paths
+- Use Zod's safeParse() for security-sensitive data
+- Document when validation might fail
+
+#### 2. No Programmatic Error Detection (Medium Impact)
+
+**Limitation**: Can't distinguish valid from invalid data programmatically
+
+**Impact**: Medium - requires runtime checks or separate validation
+
+**Mitigation**:
+- Check console for warnings during development
+- Add custom wrapper that returns success flag
+- Use Zod's safeParse() when you need to detect failures
+
+#### 3. Console-Only Logging (Medium Impact)
+
+**Limitation**: Errors only logged to console
+
+**Impact**: Medium - no error tracking, metrics, or alerts by default
+
+**Mitigation**:
+- Wrap safeParse() with custom logging in production
+- Integrate with error tracking services
+- Add metrics tracking for validation failures
+
+## Dependencies
+
+### Required Libraries
+
+- `zod` - Runtime schema validation
+
+### Path Alias
+
+Import from: `@isa/utils/z-safe-parse`
+
+### Project Configuration
+
+- **Project Name**: `utils-z-safe-parse`
+- **Prefix**: `util`
+- **Testing**: Jest
+- **Source Root**: `libs/utils/z-safe-parse/src`
+
+## License
+
+Internal ISA Frontend library - not for external distribution.
diff --git a/package-lock.json b/package-lock.json
index 1cd27f015..6ea737ea7 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -49,11 +49,11 @@
       "devDependencies": {
         "@analogjs/vite-plugin-angular": "1.19.1",
         "@analogjs/vitest-angular": "1.19.1",
-        "@angular-devkit/build-angular": "20.1.1",
+        "@angular-devkit/build-angular": "^20.3.6",
         "@angular-devkit/core": "20.1.1",
         "@angular-devkit/schematics": "20.1.1",
-        "@angular/build": "20.1.1",
-        "@angular/cli": "~20.1.0",
+        "@angular/build": "^20.3.6",
+        "@angular/cli": "^20.3.6",
         "@angular/compiler-cli": "20.1.2",
         "@angular/language-service": "20.1.2",
         "@angular/pwa": "20.1.1",
@@ -123,42 +123,58 @@
       "dev": true,
       "license": "MIT"
     },
-    "node_modules/@algolia/client-abtesting": {
-      "version": "5.32.0",
-      "resolved": "https://registry.npmjs.org/@algolia/client-abtesting/-/client-abtesting-5.32.0.tgz",
-      "integrity": "sha512-HG/6Eib6DnJYm/B2ijWFXr4txca/YOuA4K7AsEU0JBrOZSB+RU7oeDyNBPi3c0v0UDDqlkBqM3vBU/auwZlglA==",
+    "node_modules/@algolia/abtesting": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@algolia/abtesting/-/abtesting-1.1.0.tgz",
+      "integrity": "sha512-sEyWjw28a/9iluA37KLGu8vjxEIlb60uxznfTUmXImy7H5NvbpSO6yYgmgH5KiD7j+zTUUihiST0jEP12IoXow==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.32.0",
-        "@algolia/requester-browser-xhr": "5.32.0",
-        "@algolia/requester-fetch": "5.32.0",
-        "@algolia/requester-node-http": "5.32.0"
+        "@algolia/client-common": "5.35.0",
+        "@algolia/requester-browser-xhr": "5.35.0",
+        "@algolia/requester-fetch": "5.35.0",
+        "@algolia/requester-node-http": "5.35.0"
+      },
+      "engines": {
+        "node": ">= 14.0.0"
+      }
+    },
+    "node_modules/@algolia/client-abtesting": {
+      "version": "5.35.0",
+      "resolved": "https://registry.npmjs.org/@algolia/client-abtesting/-/client-abtesting-5.35.0.tgz",
+      "integrity": "sha512-uUdHxbfHdoppDVflCHMxRlj49/IllPwwQ2cQ8DLC4LXr3kY96AHBpW0dMyi6ygkn2MtFCc6BxXCzr668ZRhLBQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@algolia/client-common": "5.35.0",
+        "@algolia/requester-browser-xhr": "5.35.0",
+        "@algolia/requester-fetch": "5.35.0",
+        "@algolia/requester-node-http": "5.35.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/client-analytics": {
-      "version": "5.32.0",
-      "resolved": "https://registry.npmjs.org/@algolia/client-analytics/-/client-analytics-5.32.0.tgz",
-      "integrity": "sha512-8Y9MLU72WFQOW3HArYv16+Wvm6eGmsqbxxM1qxtm0hvSASJbxCm+zQAZe5stqysTlcWo4BJ82KEH1PfgHbJAmQ==",
+      "version": "5.35.0",
+      "resolved": "https://registry.npmjs.org/@algolia/client-analytics/-/client-analytics-5.35.0.tgz",
+      "integrity": "sha512-SunAgwa9CamLcRCPnPHx1V2uxdQwJGqb1crYrRWktWUdld0+B2KyakNEeVn5lln4VyeNtW17Ia7V7qBWyM/Skw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.32.0",
-        "@algolia/requester-browser-xhr": "5.32.0",
-        "@algolia/requester-fetch": "5.32.0",
-        "@algolia/requester-node-http": "5.32.0"
+        "@algolia/client-common": "5.35.0",
+        "@algolia/requester-browser-xhr": "5.35.0",
+        "@algolia/requester-fetch": "5.35.0",
+        "@algolia/requester-node-http": "5.35.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/client-common": {
-      "version": "5.32.0",
-      "resolved": "https://registry.npmjs.org/@algolia/client-common/-/client-common-5.32.0.tgz",
-      "integrity": "sha512-w8L+rgyXMCPBKmEdOT+RfgMrF0mT6HK60vPYWLz8DBs/P7yFdGo7urn99XCJvVLMSKXrIbZ2FMZ/i50nZTXnuQ==",
+      "version": "5.35.0",
+      "resolved": "https://registry.npmjs.org/@algolia/client-common/-/client-common-5.35.0.tgz",
+      "integrity": "sha512-ipE0IuvHu/bg7TjT2s+187kz/E3h5ssfTtjpg1LbWMgxlgiaZIgTTbyynM7NfpSJSKsgQvCQxWjGUO51WSCu7w==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -166,151 +182,151 @@
       }
     },
     "node_modules/@algolia/client-insights": {
-      "version": "5.32.0",
-      "resolved": "https://registry.npmjs.org/@algolia/client-insights/-/client-insights-5.32.0.tgz",
-      "integrity": "sha512-AdWfynhUeX7jz/LTiFU3wwzJembTbdLkQIOLs4n7PyBuxZ3jz4azV1CWbIP8AjUOFmul6uXbmYza+KqyS5CzOA==",
+      "version": "5.35.0",
+      "resolved": "https://registry.npmjs.org/@algolia/client-insights/-/client-insights-5.35.0.tgz",
+      "integrity": "sha512-UNbCXcBpqtzUucxExwTSfAe8gknAJ485NfPN6o1ziHm6nnxx97piIbcBQ3edw823Tej2Wxu1C0xBY06KgeZ7gA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.32.0",
-        "@algolia/requester-browser-xhr": "5.32.0",
-        "@algolia/requester-fetch": "5.32.0",
-        "@algolia/requester-node-http": "5.32.0"
+        "@algolia/client-common": "5.35.0",
+        "@algolia/requester-browser-xhr": "5.35.0",
+        "@algolia/requester-fetch": "5.35.0",
+        "@algolia/requester-node-http": "5.35.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/client-personalization": {
-      "version": "5.32.0",
-      "resolved": "https://registry.npmjs.org/@algolia/client-personalization/-/client-personalization-5.32.0.tgz",
-      "integrity": "sha512-bTupJY4xzGZYI4cEQcPlSjjIEzMvv80h7zXGrXY1Y0KC/n/SLiMv84v7Uy+B6AG1Kiy9FQm2ADChBLo1uEhGtQ==",
+      "version": "5.35.0",
+      "resolved": "https://registry.npmjs.org/@algolia/client-personalization/-/client-personalization-5.35.0.tgz",
+      "integrity": "sha512-/KWjttZ6UCStt4QnWoDAJ12cKlQ+fkpMtyPmBgSS2WThJQdSV/4UWcqCUqGH7YLbwlj3JjNirCu3Y7uRTClxvA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.32.0",
-        "@algolia/requester-browser-xhr": "5.32.0",
-        "@algolia/requester-fetch": "5.32.0",
-        "@algolia/requester-node-http": "5.32.0"
+        "@algolia/client-common": "5.35.0",
+        "@algolia/requester-browser-xhr": "5.35.0",
+        "@algolia/requester-fetch": "5.35.0",
+        "@algolia/requester-node-http": "5.35.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/client-query-suggestions": {
-      "version": "5.32.0",
-      "resolved": "https://registry.npmjs.org/@algolia/client-query-suggestions/-/client-query-suggestions-5.32.0.tgz",
-      "integrity": "sha512-if+YTJw1G3nDKL2omSBjQltCHUQzbaHADkcPQrGFnIGhVyHU3Dzq4g46uEv8mrL5sxL8FjiS9LvekeUlL2NRqw==",
+      "version": "5.35.0",
+      "resolved": "https://registry.npmjs.org/@algolia/client-query-suggestions/-/client-query-suggestions-5.35.0.tgz",
+      "integrity": "sha512-8oCuJCFf/71IYyvQQC+iu4kgViTODbXDk3m7yMctEncRSRV+u2RtDVlpGGfPlJQOrAY7OONwJlSHkmbbm2Kp/w==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.32.0",
-        "@algolia/requester-browser-xhr": "5.32.0",
-        "@algolia/requester-fetch": "5.32.0",
-        "@algolia/requester-node-http": "5.32.0"
+        "@algolia/client-common": "5.35.0",
+        "@algolia/requester-browser-xhr": "5.35.0",
+        "@algolia/requester-fetch": "5.35.0",
+        "@algolia/requester-node-http": "5.35.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/client-search": {
-      "version": "5.32.0",
-      "resolved": "https://registry.npmjs.org/@algolia/client-search/-/client-search-5.32.0.tgz",
-      "integrity": "sha512-kmK5nVkKb4DSUgwbveMKe4X3xHdMsPsOVJeEzBvFJ+oS7CkBPmpfHAEq+CcmiPJs20YMv6yVtUT9yPWL5WgAhg==",
+      "version": "5.35.0",
+      "resolved": "https://registry.npmjs.org/@algolia/client-search/-/client-search-5.35.0.tgz",
+      "integrity": "sha512-FfmdHTrXhIduWyyuko1YTcGLuicVbhUyRjO3HbXE4aP655yKZgdTIfMhZ/V5VY9bHuxv/fGEh3Od1Lvv2ODNTg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.32.0",
-        "@algolia/requester-browser-xhr": "5.32.0",
-        "@algolia/requester-fetch": "5.32.0",
-        "@algolia/requester-node-http": "5.32.0"
+        "@algolia/client-common": "5.35.0",
+        "@algolia/requester-browser-xhr": "5.35.0",
+        "@algolia/requester-fetch": "5.35.0",
+        "@algolia/requester-node-http": "5.35.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/ingestion": {
-      "version": "1.32.0",
-      "resolved": "https://registry.npmjs.org/@algolia/ingestion/-/ingestion-1.32.0.tgz",
-      "integrity": "sha512-PZTqjJbx+fmPuT2ud1n4vYDSF1yrT//vOGI9HNYKNA0PM0xGUBWigf5gRivHsXa3oBnUlTyHV9j7Kqx5BHbVHQ==",
+      "version": "1.35.0",
+      "resolved": "https://registry.npmjs.org/@algolia/ingestion/-/ingestion-1.35.0.tgz",
+      "integrity": "sha512-gPzACem9IL1Co8mM1LKMhzn1aSJmp+Vp434An4C0OBY4uEJRcqsLN3uLBlY+bYvFg8C8ImwM9YRiKczJXRk0XA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.32.0",
-        "@algolia/requester-browser-xhr": "5.32.0",
-        "@algolia/requester-fetch": "5.32.0",
-        "@algolia/requester-node-http": "5.32.0"
+        "@algolia/client-common": "5.35.0",
+        "@algolia/requester-browser-xhr": "5.35.0",
+        "@algolia/requester-fetch": "5.35.0",
+        "@algolia/requester-node-http": "5.35.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/monitoring": {
-      "version": "1.32.0",
-      "resolved": "https://registry.npmjs.org/@algolia/monitoring/-/monitoring-1.32.0.tgz",
-      "integrity": "sha512-kYYoOGjvNQAmHDS1v5sBj+0uEL9RzYqH/TAdq8wmcV+/22weKt/fjh+6LfiqkS1SCZFYYrwGnirrUhUM36lBIQ==",
+      "version": "1.35.0",
+      "resolved": "https://registry.npmjs.org/@algolia/monitoring/-/monitoring-1.35.0.tgz",
+      "integrity": "sha512-w9MGFLB6ashI8BGcQoVt7iLgDIJNCn4OIu0Q0giE3M2ItNrssvb8C0xuwJQyTy1OFZnemG0EB1OvXhIHOvQwWw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.32.0",
-        "@algolia/requester-browser-xhr": "5.32.0",
-        "@algolia/requester-fetch": "5.32.0",
-        "@algolia/requester-node-http": "5.32.0"
+        "@algolia/client-common": "5.35.0",
+        "@algolia/requester-browser-xhr": "5.35.0",
+        "@algolia/requester-fetch": "5.35.0",
+        "@algolia/requester-node-http": "5.35.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/recommend": {
-      "version": "5.32.0",
-      "resolved": "https://registry.npmjs.org/@algolia/recommend/-/recommend-5.32.0.tgz",
-      "integrity": "sha512-jyIBLdskjPAL7T1g57UMfUNx+PzvYbxKslwRUKBrBA6sNEsYCFdxJAtZSLUMmw6MC98RDt4ksmEl5zVMT5bsuw==",
+      "version": "5.35.0",
+      "resolved": "https://registry.npmjs.org/@algolia/recommend/-/recommend-5.35.0.tgz",
+      "integrity": "sha512-AhrVgaaXAb8Ue0u2nuRWwugt0dL5UmRgS9LXe0Hhz493a8KFeZVUE56RGIV3hAa6tHzmAV7eIoqcWTQvxzlJeQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.32.0",
-        "@algolia/requester-browser-xhr": "5.32.0",
-        "@algolia/requester-fetch": "5.32.0",
-        "@algolia/requester-node-http": "5.32.0"
+        "@algolia/client-common": "5.35.0",
+        "@algolia/requester-browser-xhr": "5.35.0",
+        "@algolia/requester-fetch": "5.35.0",
+        "@algolia/requester-node-http": "5.35.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/requester-browser-xhr": {
-      "version": "5.32.0",
-      "resolved": "https://registry.npmjs.org/@algolia/requester-browser-xhr/-/requester-browser-xhr-5.32.0.tgz",
-      "integrity": "sha512-eDp14z92Gt6JlFgiexImcWWH+Lk07s/FtxcoDaGrE4UVBgpwqOO6AfQM6dXh1pvHxlDFbMJihHc/vj3gBhPjqQ==",
+      "version": "5.35.0",
+      "resolved": "https://registry.npmjs.org/@algolia/requester-browser-xhr/-/requester-browser-xhr-5.35.0.tgz",
+      "integrity": "sha512-diY415KLJZ6x1Kbwl9u96Jsz0OstE3asjXtJ9pmk1d+5gPuQ5jQyEsgC+WmEXzlec3iuVszm8AzNYYaqw6B+Zw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.32.0"
+        "@algolia/client-common": "5.35.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/requester-fetch": {
-      "version": "5.32.0",
-      "resolved": "https://registry.npmjs.org/@algolia/requester-fetch/-/requester-fetch-5.32.0.tgz",
-      "integrity": "sha512-rnWVglh/K75hnaLbwSc2t7gCkbq1ldbPgeIKDUiEJxZ4mlguFgcltWjzpDQ/t1LQgxk9HdIFcQfM17Hid3aQ6Q==",
+      "version": "5.35.0",
+      "resolved": "https://registry.npmjs.org/@algolia/requester-fetch/-/requester-fetch-5.35.0.tgz",
+      "integrity": "sha512-uydqnSmpAjrgo8bqhE9N1wgcB98psTRRQXcjc4izwMB7yRl9C8uuAQ/5YqRj04U0mMQ+fdu2fcNF6m9+Z1BzDQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.32.0"
+        "@algolia/client-common": "5.35.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/requester-node-http": {
-      "version": "5.32.0",
-      "resolved": "https://registry.npmjs.org/@algolia/requester-node-http/-/requester-node-http-5.32.0.tgz",
-      "integrity": "sha512-LbzQ04+VLkzXY4LuOzgyjqEv/46Gwrk55PldaglMJ4i4eDXSRXGKkwJpXFwsoU+c1HMQlHIyjJBhrfsfdyRmyQ==",
+      "version": "5.35.0",
+      "resolved": "https://registry.npmjs.org/@algolia/requester-node-http/-/requester-node-http-5.35.0.tgz",
+      "integrity": "sha512-RgLX78ojYOrThJHrIiPzT4HW3yfQa0D7K+MQ81rhxqaNyNBu4F1r+72LNHYH/Z+y9I1Mrjrd/c/Ue5zfDgAEjQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.32.0"
+        "@algolia/client-common": "5.35.0"
       },
       "engines": {
         "node": ">= 14.0.0"
@@ -348,7 +364,6 @@
       "integrity": "sha512-bl38MZtcP4xuT5+HgdL3H4zNMXlUjLSkk8zONw7bccNozWWxHKzI5u81AacFYjB7SYXR6Z3cWDYMEtVXZO5f2A==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "ts-morph": "^21.0.0",
         "vfile": "^6.0.3"
@@ -413,7 +428,6 @@
       "integrity": "sha512-VtXxfJzrBZ8MQN83shXNaTUaLSOIwa+4/3LD5drxSnHuYJrz+d3FIApWAxcA9QzucsTDZwXyFxaWZN/e5XVm6g==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@angular-devkit/core": "20.3.6",
         "rxjs": "7.8.2"
@@ -476,55 +490,54 @@
       }
     },
     "node_modules/@angular-devkit/build-angular": {
-      "version": "20.1.1",
-      "resolved": "https://registry.npmjs.org/@angular-devkit/build-angular/-/build-angular-20.1.1.tgz",
-      "integrity": "sha512-a14mMnb5jpG9AtetW1IdGLVgb39aCdPXVTraCoBdiIY+TvKBnBb+zqDYCwytyXL7Q6aascVwl7QF2DHvWziyOQ==",
+      "version": "20.3.6",
+      "resolved": "https://registry.npmjs.org/@angular-devkit/build-angular/-/build-angular-20.3.6.tgz",
+      "integrity": "sha512-yCybq8Lh6PnuN5oa81qFDmHjV/MMB1tOY99NU6N/DM4IcbGdyS8IFEeVvM3ohz6bTnqvkmi3rSxWs1jDWvm5/Q==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@ampproject/remapping": "2.3.0",
-        "@angular-devkit/architect": "0.2001.1",
-        "@angular-devkit/build-webpack": "0.2001.1",
-        "@angular-devkit/core": "20.1.1",
-        "@angular/build": "20.1.1",
-        "@babel/core": "7.27.7",
-        "@babel/generator": "7.27.5",
+        "@angular-devkit/architect": "0.2003.6",
+        "@angular-devkit/build-webpack": "0.2003.6",
+        "@angular-devkit/core": "20.3.6",
+        "@angular/build": "20.3.6",
+        "@babel/core": "7.28.3",
+        "@babel/generator": "7.28.3",
         "@babel/helper-annotate-as-pure": "7.27.3",
         "@babel/helper-split-export-declaration": "7.24.7",
-        "@babel/plugin-transform-async-generator-functions": "7.27.1",
+        "@babel/plugin-transform-async-generator-functions": "7.28.0",
         "@babel/plugin-transform-async-to-generator": "7.27.1",
-        "@babel/plugin-transform-runtime": "7.27.4",
-        "@babel/preset-env": "7.27.2",
-        "@babel/runtime": "7.27.6",
+        "@babel/plugin-transform-runtime": "7.28.3",
+        "@babel/preset-env": "7.28.3",
+        "@babel/runtime": "7.28.3",
         "@discoveryjs/json-ext": "0.6.3",
-        "@ngtools/webpack": "20.1.1",
+        "@ngtools/webpack": "20.3.6",
         "ansi-colors": "4.1.3",
         "autoprefixer": "10.4.21",
         "babel-loader": "10.0.0",
         "browserslist": "^4.21.5",
-        "copy-webpack-plugin": "13.0.0",
+        "copy-webpack-plugin": "13.0.1",
         "css-loader": "7.1.2",
-        "esbuild-wasm": "0.25.5",
+        "esbuild-wasm": "0.25.9",
         "fast-glob": "3.3.3",
         "http-proxy-middleware": "3.0.5",
         "istanbul-lib-instrument": "6.0.3",
         "jsonc-parser": "3.3.1",
         "karma-source-map-support": "1.4.0",
-        "less": "4.3.0",
+        "less": "4.4.0",
         "less-loader": "12.3.0",
         "license-webpack-plugin": "4.0.2",
         "loader-utils": "3.3.1",
-        "mini-css-extract-plugin": "2.9.2",
-        "open": "10.1.2",
+        "mini-css-extract-plugin": "2.9.4",
+        "open": "10.2.0",
         "ora": "8.2.0",
-        "picomatch": "4.0.2",
-        "piscina": "5.1.2",
+        "picomatch": "4.0.3",
+        "piscina": "5.1.3",
         "postcss": "8.5.6",
         "postcss-loader": "8.1.1",
         "resolve-url-loader": "5.0.0",
         "rxjs": "7.8.2",
-        "sass": "1.89.2",
+        "sass": "1.90.0",
         "sass-loader": "16.0.5",
         "semver": "7.7.2",
         "source-map-loader": "5.0.0",
@@ -532,7 +545,7 @@
         "terser": "5.43.1",
         "tree-kill": "1.2.2",
         "tslib": "2.8.1",
-        "webpack": "5.99.9",
+        "webpack": "5.101.2",
         "webpack-dev-middleware": "7.4.2",
         "webpack-dev-server": "5.2.2",
         "webpack-merge": "6.0.1",
@@ -544,7 +557,7 @@
         "yarn": ">= 1.13.0"
       },
       "optionalDependencies": {
-        "esbuild": "0.25.5"
+        "esbuild": "0.25.9"
       },
       "peerDependencies": {
         "@angular/compiler-cli": "^20.0.0",
@@ -553,7 +566,7 @@
         "@angular/platform-browser": "^20.0.0",
         "@angular/platform-server": "^20.0.0",
         "@angular/service-worker": "^20.0.0",
-        "@angular/ssr": "^20.1.1",
+        "@angular/ssr": "^20.3.6",
         "@web/test-runner": "^0.20.0",
         "browser-sync": "^3.0.2",
         "jest": "^29.5.0",
@@ -562,7 +575,7 @@
         "ng-packagr": "^20.0.0",
         "protractor": "^7.0.0",
         "tailwindcss": "^2.0.0 || ^3.0.0 || ^4.0.0",
-        "typescript": ">=5.8 <5.9"
+        "typescript": ">=5.8 <6.0"
       },
       "peerDependenciesMeta": {
         "@angular/core": {
@@ -609,30 +622,636 @@
         }
       }
     },
-    "node_modules/@angular-devkit/build-angular/node_modules/@angular-devkit/architect": {
-      "version": "0.2001.1",
-      "resolved": "https://registry.npmjs.org/@angular-devkit/architect/-/architect-0.2001.1.tgz",
-      "integrity": "sha512-jU+fvaiS5bjh3znpHLEeKQIYb+ZVKNP0xRu3+E9EmweyG4E8AdvZnLvKTe61Ikhul2zBTFBUv46er7CHjAGEEg==",
+    "node_modules/@angular-devkit/build-angular/node_modules/@angular-devkit/core": {
+      "version": "20.3.6",
+      "resolved": "https://registry.npmjs.org/@angular-devkit/core/-/core-20.3.6.tgz",
+      "integrity": "sha512-uLRk3865Iz/EO9Zm/mrFfdyoZinJBihXE6HVDYRYjAqsgW14LsD8pkpWy9+LYlOwcH96Ndnev+msxaTJaNXtPg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@angular-devkit/core": "20.1.1",
-        "rxjs": "7.8.2"
+        "ajv": "8.17.1",
+        "ajv-formats": "3.0.1",
+        "jsonc-parser": "3.3.1",
+        "picomatch": "4.0.3",
+        "rxjs": "7.8.2",
+        "source-map": "0.7.6"
       },
       "engines": {
         "node": "^20.19.0 || ^22.12.0 || >=24.0.0",
         "npm": "^6.11.0 || ^7.5.6 || >=8.0.0",
         "yarn": ">= 1.13.0"
+      },
+      "peerDependencies": {
+        "chokidar": "^4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "chokidar": {
+          "optional": true
+        }
       }
     },
-    "node_modules/@angular-devkit/build-webpack": {
-      "version": "0.2001.1",
-      "resolved": "https://registry.npmjs.org/@angular-devkit/build-webpack/-/build-webpack-0.2001.1.tgz",
-      "integrity": "sha512-+UOleFjtW/OxehjaR+y4gFzNgVXdkhXcTC1XxiyeCr/ElQ8EBWMEYKBs/+QWTZqNJ/HSbZG4MnpGWl5djka1jw==",
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/aix-ppc64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.9.tgz",
+      "integrity": "sha512-OaGtL73Jck6pBKjNIe24BnFE6agGl+6KxDtTfHhy1HmhthfKouEcOhqpSL64K4/0WCtbKFLOdzD/44cJ4k9opA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/android-arm": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.9.tgz",
+      "integrity": "sha512-5WNI1DaMtxQ7t7B6xa572XMXpHAaI/9Hnhk8lcxF4zVN4xstUgTlvuGDorBguKEnZO70qwEcLpfifMLoxiPqHQ==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/android-arm64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.9.tgz",
+      "integrity": "sha512-IDrddSmpSv51ftWslJMvl3Q2ZT98fUSL2/rlUXuVqRXHCs5EUF1/f+jbjF5+NG9UffUDMCiTyh8iec7u8RlTLg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/android-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.9.tgz",
+      "integrity": "sha512-I853iMZ1hWZdNllhVZKm34f4wErd4lMyeV7BLzEExGEIZYsOzqDWDf+y082izYUE8gtJnYHdeDpN/6tUdwvfiw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/darwin-arm64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.9.tgz",
+      "integrity": "sha512-XIpIDMAjOELi/9PB30vEbVMs3GV1v2zkkPnuyRRURbhqjyzIINwj+nbQATh4H9GxUgH1kFsEyQMxwiLFKUS6Rg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/darwin-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.9.tgz",
+      "integrity": "sha512-jhHfBzjYTA1IQu8VyrjCX4ApJDnH+ez+IYVEoJHeqJm9VhG9Dh2BYaJritkYK3vMaXrf7Ogr/0MQ8/MeIefsPQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.9.tgz",
+      "integrity": "sha512-z93DmbnY6fX9+KdD4Ue/H6sYs+bhFQJNCPZsi4XWJoYblUqT06MQUdBCpcSfuiN72AbqeBFu5LVQTjfXDE2A6Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/freebsd-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.9.tgz",
+      "integrity": "sha512-mrKX6H/vOyo5v71YfXWJxLVxgy1kyt1MQaD8wZJgJfG4gq4DpQGpgTB74e5yBeQdyMTbgxp0YtNj7NuHN0PoZg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/linux-arm": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.9.tgz",
+      "integrity": "sha512-HBU2Xv78SMgaydBmdor38lg8YDnFKSARg1Q6AT0/y2ezUAKiZvc211RDFHlEZRFNRVhcMamiToo7bDx3VEOYQw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/linux-arm64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.9.tgz",
+      "integrity": "sha512-BlB7bIcLT3G26urh5Dmse7fiLmLXnRlopw4s8DalgZ8ef79Jj4aUcYbk90g8iCa2467HX8SAIidbL7gsqXHdRw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/linux-ia32": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.9.tgz",
+      "integrity": "sha512-e7S3MOJPZGp2QW6AK6+Ly81rC7oOSerQ+P8L0ta4FhVi+/j/v2yZzx5CqqDaWjtPFfYz21Vi1S0auHrap3Ma3A==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/linux-loong64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.9.tgz",
+      "integrity": "sha512-Sbe10Bnn0oUAB2AalYztvGcK+o6YFFA/9829PhOCUS9vkJElXGdphz0A3DbMdP8gmKkqPmPcMJmJOrI3VYB1JQ==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/linux-mips64el": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.9.tgz",
+      "integrity": "sha512-YcM5br0mVyZw2jcQeLIkhWtKPeVfAerES5PvOzaDxVtIyZ2NUBZKNLjC5z3/fUlDgT6w89VsxP2qzNipOaaDyA==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/linux-ppc64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.9.tgz",
+      "integrity": "sha512-++0HQvasdo20JytyDpFvQtNrEsAgNG2CY1CLMwGXfFTKGBGQT3bOeLSYE2l1fYdvML5KUuwn9Z8L1EWe2tzs1w==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/linux-riscv64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.9.tgz",
+      "integrity": "sha512-uNIBa279Y3fkjV+2cUjx36xkx7eSjb8IvnL01eXUKXez/CBHNRw5ekCGMPM0BcmqBxBcdgUWuUXmVWwm4CH9kg==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/linux-s390x": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.9.tgz",
+      "integrity": "sha512-Mfiphvp3MjC/lctb+7D287Xw1DGzqJPb/J2aHHcHxflUo+8tmN/6d4k6I2yFR7BVo5/g7x2Monq4+Yew0EHRIA==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/linux-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.9.tgz",
+      "integrity": "sha512-iSwByxzRe48YVkmpbgoxVzn76BXjlYFXC7NvLYq+b+kDjyyk30J0JY47DIn8z1MO3K0oSl9fZoRmZPQI4Hklzg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.9.tgz",
+      "integrity": "sha512-9jNJl6FqaUG+COdQMjSCGW4QiMHH88xWbvZ+kRVblZsWrkXlABuGdFJ1E9L7HK+T0Yqd4akKNa/lO0+jDxQD4Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/netbsd-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.9.tgz",
+      "integrity": "sha512-RLLdkflmqRG8KanPGOU7Rpg829ZHu8nFy5Pqdi9U01VYtG9Y0zOG6Vr2z4/S+/3zIyOxiK6cCeYNWOFR9QP87g==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.9.tgz",
+      "integrity": "sha512-YaFBlPGeDasft5IIM+CQAhJAqS3St3nJzDEgsgFixcfZeyGPCd6eJBWzke5piZuZ7CtL656eOSYKk4Ls2C0FRQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/openbsd-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.9.tgz",
+      "integrity": "sha512-1MkgTCuvMGWuqVtAvkpkXFmtL8XhWy+j4jaSO2wxfJtilVCi0ZE37b8uOdMItIHz4I6z1bWWtEX4CJwcKYLcuA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/sunos-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.9.tgz",
+      "integrity": "sha512-WjH4s6hzo00nNezhp3wFIAfmGZ8U7KtrJNlFMRKxiI9mxEK1scOMAaa9i4crUtu+tBr+0IN6JCuAcSBJZfnphw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/win32-arm64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.9.tgz",
+      "integrity": "sha512-mGFrVJHmZiRqmP8xFOc6b84/7xa5y5YvR1x8djzXpJBSv/UsNK6aqec+6JDjConTgvvQefdGhFDAs2DLAds6gQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/win32-ia32": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.9.tgz",
+      "integrity": "sha512-b33gLVU2k11nVx1OhX3C8QQP6UHQK4ZtN56oFWvVXvz2VkDoe6fbG8TOgHFxEvqeqohmRnIHe5A1+HADk4OQww==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/@esbuild/win32-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.9.tgz",
+      "integrity": "sha512-PPOl1mi6lpLNQxnGoyAfschAodRFYXJ+9fs6WHXz7CSWKbOqiMZsubC+BQsVKuul+3vKLuwTHsS2c2y9EoKwxQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/esbuild": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.9.tgz",
+      "integrity": "sha512-CRbODhYyQx3qp7ZEwzxOk4JBqmD/seJrzPa/cGjY1VtIn5E09Oi9/dB4JwctnfZ8Q8iT7rioVv5k/FNT/uf54g==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.25.9",
+        "@esbuild/android-arm": "0.25.9",
+        "@esbuild/android-arm64": "0.25.9",
+        "@esbuild/android-x64": "0.25.9",
+        "@esbuild/darwin-arm64": "0.25.9",
+        "@esbuild/darwin-x64": "0.25.9",
+        "@esbuild/freebsd-arm64": "0.25.9",
+        "@esbuild/freebsd-x64": "0.25.9",
+        "@esbuild/linux-arm": "0.25.9",
+        "@esbuild/linux-arm64": "0.25.9",
+        "@esbuild/linux-ia32": "0.25.9",
+        "@esbuild/linux-loong64": "0.25.9",
+        "@esbuild/linux-mips64el": "0.25.9",
+        "@esbuild/linux-ppc64": "0.25.9",
+        "@esbuild/linux-riscv64": "0.25.9",
+        "@esbuild/linux-s390x": "0.25.9",
+        "@esbuild/linux-x64": "0.25.9",
+        "@esbuild/netbsd-arm64": "0.25.9",
+        "@esbuild/netbsd-x64": "0.25.9",
+        "@esbuild/openbsd-arm64": "0.25.9",
+        "@esbuild/openbsd-x64": "0.25.9",
+        "@esbuild/openharmony-arm64": "0.25.9",
+        "@esbuild/sunos-x64": "0.25.9",
+        "@esbuild/win32-arm64": "0.25.9",
+        "@esbuild/win32-ia32": "0.25.9",
+        "@esbuild/win32-x64": "0.25.9"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/eslint-scope": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-5.1.1.tgz",
+      "integrity": "sha512-2NxwbF/hZ0KpepYN0cNbo+FN6XoK7GaHlQhgx/hIZl6Va0bF45RQOOwhLIy8lQDbuCiadSLCBnH2CFYquit5bw==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "esrecurse": "^4.3.0",
+        "estraverse": "^4.1.1"
+      },
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/estraverse": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-4.3.0.tgz",
+      "integrity": "sha512-39nnKffWz8xN1BU/2c79n9nB9HDzo0niYUqx6xyqUnyoAnQyyWpOTdZEeiCch8BBu515t4wp9ZmgVfVhn9EBpw==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=4.0"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/json-parse-even-better-errors": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz",
+      "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/mime-db": {
+      "version": "1.52.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
+      "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/mime-types": {
+      "version": "2.1.35",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
+      "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@angular-devkit/architect": "0.2001.1",
+        "mime-db": "1.52.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/picomatch": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
+      "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/source-map": {
+      "version": "0.7.6",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.7.6.tgz",
+      "integrity": "sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/@angular-devkit/build-angular/node_modules/webpack": {
+      "version": "5.101.2",
+      "resolved": "https://registry.npmjs.org/webpack/-/webpack-5.101.2.tgz",
+      "integrity": "sha512-4JLXU0tD6OZNVqlwzm3HGEhAHufSiyv+skb7q0d2367VDMzrU1Q/ZeepvkcHH0rZie6uqEtTQQe0OEOOluH3Mg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/eslint-scope": "^3.7.7",
+        "@types/estree": "^1.0.8",
+        "@types/json-schema": "^7.0.15",
+        "@webassemblyjs/ast": "^1.14.1",
+        "@webassemblyjs/wasm-edit": "^1.14.1",
+        "@webassemblyjs/wasm-parser": "^1.14.1",
+        "acorn": "^8.15.0",
+        "acorn-import-phases": "^1.0.3",
+        "browserslist": "^4.24.0",
+        "chrome-trace-event": "^1.0.2",
+        "enhanced-resolve": "^5.17.3",
+        "es-module-lexer": "^1.2.1",
+        "eslint-scope": "5.1.1",
+        "events": "^3.2.0",
+        "glob-to-regexp": "^0.4.1",
+        "graceful-fs": "^4.2.11",
+        "json-parse-even-better-errors": "^2.3.1",
+        "loader-runner": "^4.2.0",
+        "mime-types": "^2.1.27",
+        "neo-async": "^2.6.2",
+        "schema-utils": "^4.3.2",
+        "tapable": "^2.1.1",
+        "terser-webpack-plugin": "^5.3.11",
+        "watchpack": "^2.4.1",
+        "webpack-sources": "^3.3.3"
+      },
+      "bin": {
+        "webpack": "bin/webpack.js"
+      },
+      "engines": {
+        "node": ">=10.13.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/webpack"
+      },
+      "peerDependenciesMeta": {
+        "webpack-cli": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@angular-devkit/build-webpack": {
+      "version": "0.2003.6",
+      "resolved": "https://registry.npmjs.org/@angular-devkit/build-webpack/-/build-webpack-0.2003.6.tgz",
+      "integrity": "sha512-KcPIZChvJH2+MscD66Ef6+Od8bVjZXnRHpCCxgcmT+VOC2682cCgBVeZFXXlC7+SI8MfFLashIIY3RN5ORYv2w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@angular-devkit/architect": "0.2003.6",
         "rxjs": "7.8.2"
       },
       "engines": {
@@ -645,29 +1264,12 @@
         "webpack-dev-server": "^5.0.2"
       }
     },
-    "node_modules/@angular-devkit/build-webpack/node_modules/@angular-devkit/architect": {
-      "version": "0.2001.1",
-      "resolved": "https://registry.npmjs.org/@angular-devkit/architect/-/architect-0.2001.1.tgz",
-      "integrity": "sha512-jU+fvaiS5bjh3znpHLEeKQIYb+ZVKNP0xRu3+E9EmweyG4E8AdvZnLvKTe61Ikhul2zBTFBUv46er7CHjAGEEg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@angular-devkit/core": "20.1.1",
-        "rxjs": "7.8.2"
-      },
-      "engines": {
-        "node": "^20.19.0 || ^22.12.0 || >=24.0.0",
-        "npm": "^6.11.0 || ^7.5.6 || >=8.0.0",
-        "yarn": ">= 1.13.0"
-      }
-    },
     "node_modules/@angular-devkit/core": {
       "version": "20.1.1",
       "resolved": "https://registry.npmjs.org/@angular-devkit/core/-/core-20.1.1.tgz",
       "integrity": "sha512-5rKL/WfMhZOi0MyYWXK95kPwxSd7zhZieyo3Idtg0B1VMFP4jIa4jRkV7uz55HRPOl5/kK3aIrsxgtKuxQg50Q==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "ajv": "8.17.1",
         "ajv-formats": "3.0.1",
@@ -696,7 +1298,6 @@
       "integrity": "sha512-G87e0u3V9E2iqwoV8nBIuLNtMUAnb/A62LNq9eTJguyVEC0HSRWQnByhUvmv6mlABLa4worZJnE5vMbXW1LeQg==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@angular-devkit/core": "20.1.1",
         "jsonc-parser": "3.3.1",
@@ -811,7 +1412,6 @@
       "integrity": "sha512-giIMYORf8P8MbBxh6EUfiR/7Y+omxJtK2C7a8lYTtLSOIGO0D8c8hXx9hTlPcdupVX+xZXDuZ85c9JDen+JSSA==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@angular-eslint/bundled-angular-compiler": "20.1.1",
         "eslint-scope": "^8.0.2"
@@ -841,7 +1441,6 @@
       "resolved": "https://registry.npmjs.org/@angular/animations/-/animations-20.1.2.tgz",
       "integrity": "sha512-r1JnNXZEg2Rrz53Mr4D4/S7v6ozZ3FPzJJo38lDq2WJKSkKc09R9fjFWIB/rXwEXUuiWEfNfxx+O4g6rrbXWWA==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "tslib": "^2.3.0"
       },
@@ -854,38 +1453,37 @@
       }
     },
     "node_modules/@angular/build": {
-      "version": "20.1.1",
-      "resolved": "https://registry.npmjs.org/@angular/build/-/build-20.1.1.tgz",
-      "integrity": "sha512-N9tKfHatZEdy/uGX9atJQKVIejAvRbOMwpBj9Z5Y2RtR2vTDOOm0q86OYQW8baK19b2/HkHRe6PSPeiHpTG+8g==",
+      "version": "20.3.6",
+      "resolved": "https://registry.npmjs.org/@angular/build/-/build-20.3.6.tgz",
+      "integrity": "sha512-O5qyxCCe77tu1zy9XudKxqFqi5zih0ZI8J8Anra/ZZdtTKbLMprXMGFzMYzwCqvcIzzbmOumkSJKoXbFazHaaw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@ampproject/remapping": "2.3.0",
-        "@angular-devkit/architect": "0.2001.1",
-        "@babel/core": "7.27.7",
+        "@angular-devkit/architect": "0.2003.6",
+        "@babel/core": "7.28.3",
         "@babel/helper-annotate-as-pure": "7.27.3",
         "@babel/helper-split-export-declaration": "7.24.7",
-        "@inquirer/confirm": "5.1.13",
+        "@inquirer/confirm": "5.1.14",
         "@vitejs/plugin-basic-ssl": "2.1.0",
-        "beasties": "0.3.4",
+        "beasties": "0.3.5",
         "browserslist": "^4.23.0",
-        "esbuild": "0.25.5",
+        "esbuild": "0.25.9",
         "https-proxy-agent": "7.0.6",
         "istanbul-lib-instrument": "6.0.3",
         "jsonc-parser": "3.3.1",
-        "listr2": "8.3.3",
+        "listr2": "9.0.1",
         "magic-string": "0.30.17",
         "mrmime": "2.0.1",
-        "parse5-html-rewriting-stream": "7.1.0",
-        "picomatch": "4.0.2",
-        "piscina": "5.1.2",
-        "rollup": "4.44.1",
-        "sass": "1.89.2",
+        "parse5-html-rewriting-stream": "8.0.0",
+        "picomatch": "4.0.3",
+        "piscina": "5.1.3",
+        "rollup": "4.52.3",
+        "sass": "1.90.0",
         "semver": "7.7.2",
         "source-map-support": "0.5.21",
         "tinyglobby": "0.2.14",
-        "vite": "7.0.0",
+        "vite": "7.1.5",
         "watchpack": "2.4.4"
       },
       "engines": {
@@ -894,7 +1492,7 @@
         "yarn": ">= 1.13.0"
       },
       "optionalDependencies": {
-        "lmdb": "3.4.1"
+        "lmdb": "3.4.2"
       },
       "peerDependencies": {
         "@angular/compiler": "^20.0.0",
@@ -904,14 +1502,14 @@
         "@angular/platform-browser": "^20.0.0",
         "@angular/platform-server": "^20.0.0",
         "@angular/service-worker": "^20.0.0",
-        "@angular/ssr": "^20.1.1",
+        "@angular/ssr": "^20.3.6",
         "karma": "^6.4.0",
         "less": "^4.2.0",
         "ng-packagr": "^20.0.0",
         "postcss": "^8.4.0",
         "tailwindcss": "^2.0.0 || ^3.0.0 || ^4.0.0",
         "tslib": "^2.3.0",
-        "typescript": ">=5.8 <5.9",
+        "typescript": ">=5.8 <6.0",
         "vitest": "^3.1.1"
       },
       "peerDependenciesMeta": {
@@ -953,35 +1551,552 @@
         }
       }
     },
-    "node_modules/@angular/build/node_modules/@angular-devkit/architect": {
-      "version": "0.2001.1",
-      "resolved": "https://registry.npmjs.org/@angular-devkit/architect/-/architect-0.2001.1.tgz",
-      "integrity": "sha512-jU+fvaiS5bjh3znpHLEeKQIYb+ZVKNP0xRu3+E9EmweyG4E8AdvZnLvKTe61Ikhul2zBTFBUv46er7CHjAGEEg==",
+    "node_modules/@angular/build/node_modules/@esbuild/aix-ppc64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.9.tgz",
+      "integrity": "sha512-OaGtL73Jck6pBKjNIe24BnFE6agGl+6KxDtTfHhy1HmhthfKouEcOhqpSL64K4/0WCtbKFLOdzD/44cJ4k9opA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/android-arm": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.9.tgz",
+      "integrity": "sha512-5WNI1DaMtxQ7t7B6xa572XMXpHAaI/9Hnhk8lcxF4zVN4xstUgTlvuGDorBguKEnZO70qwEcLpfifMLoxiPqHQ==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/android-arm64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.9.tgz",
+      "integrity": "sha512-IDrddSmpSv51ftWslJMvl3Q2ZT98fUSL2/rlUXuVqRXHCs5EUF1/f+jbjF5+NG9UffUDMCiTyh8iec7u8RlTLg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/android-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.9.tgz",
+      "integrity": "sha512-I853iMZ1hWZdNllhVZKm34f4wErd4lMyeV7BLzEExGEIZYsOzqDWDf+y082izYUE8gtJnYHdeDpN/6tUdwvfiw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/darwin-arm64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.9.tgz",
+      "integrity": "sha512-XIpIDMAjOELi/9PB30vEbVMs3GV1v2zkkPnuyRRURbhqjyzIINwj+nbQATh4H9GxUgH1kFsEyQMxwiLFKUS6Rg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/darwin-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.9.tgz",
+      "integrity": "sha512-jhHfBzjYTA1IQu8VyrjCX4ApJDnH+ez+IYVEoJHeqJm9VhG9Dh2BYaJritkYK3vMaXrf7Ogr/0MQ8/MeIefsPQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.9.tgz",
+      "integrity": "sha512-z93DmbnY6fX9+KdD4Ue/H6sYs+bhFQJNCPZsi4XWJoYblUqT06MQUdBCpcSfuiN72AbqeBFu5LVQTjfXDE2A6Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/freebsd-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.9.tgz",
+      "integrity": "sha512-mrKX6H/vOyo5v71YfXWJxLVxgy1kyt1MQaD8wZJgJfG4gq4DpQGpgTB74e5yBeQdyMTbgxp0YtNj7NuHN0PoZg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/linux-arm": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.9.tgz",
+      "integrity": "sha512-HBU2Xv78SMgaydBmdor38lg8YDnFKSARg1Q6AT0/y2ezUAKiZvc211RDFHlEZRFNRVhcMamiToo7bDx3VEOYQw==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/linux-arm64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.9.tgz",
+      "integrity": "sha512-BlB7bIcLT3G26urh5Dmse7fiLmLXnRlopw4s8DalgZ8ef79Jj4aUcYbk90g8iCa2467HX8SAIidbL7gsqXHdRw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/linux-ia32": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.9.tgz",
+      "integrity": "sha512-e7S3MOJPZGp2QW6AK6+Ly81rC7oOSerQ+P8L0ta4FhVi+/j/v2yZzx5CqqDaWjtPFfYz21Vi1S0auHrap3Ma3A==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/linux-loong64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.9.tgz",
+      "integrity": "sha512-Sbe10Bnn0oUAB2AalYztvGcK+o6YFFA/9829PhOCUS9vkJElXGdphz0A3DbMdP8gmKkqPmPcMJmJOrI3VYB1JQ==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/linux-mips64el": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.9.tgz",
+      "integrity": "sha512-YcM5br0mVyZw2jcQeLIkhWtKPeVfAerES5PvOzaDxVtIyZ2NUBZKNLjC5z3/fUlDgT6w89VsxP2qzNipOaaDyA==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/linux-ppc64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.9.tgz",
+      "integrity": "sha512-++0HQvasdo20JytyDpFvQtNrEsAgNG2CY1CLMwGXfFTKGBGQT3bOeLSYE2l1fYdvML5KUuwn9Z8L1EWe2tzs1w==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/linux-riscv64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.9.tgz",
+      "integrity": "sha512-uNIBa279Y3fkjV+2cUjx36xkx7eSjb8IvnL01eXUKXez/CBHNRw5ekCGMPM0BcmqBxBcdgUWuUXmVWwm4CH9kg==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/linux-s390x": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.9.tgz",
+      "integrity": "sha512-Mfiphvp3MjC/lctb+7D287Xw1DGzqJPb/J2aHHcHxflUo+8tmN/6d4k6I2yFR7BVo5/g7x2Monq4+Yew0EHRIA==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/linux-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.9.tgz",
+      "integrity": "sha512-iSwByxzRe48YVkmpbgoxVzn76BXjlYFXC7NvLYq+b+kDjyyk30J0JY47DIn8z1MO3K0oSl9fZoRmZPQI4Hklzg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.9.tgz",
+      "integrity": "sha512-9jNJl6FqaUG+COdQMjSCGW4QiMHH88xWbvZ+kRVblZsWrkXlABuGdFJ1E9L7HK+T0Yqd4akKNa/lO0+jDxQD4Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/netbsd-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.9.tgz",
+      "integrity": "sha512-RLLdkflmqRG8KanPGOU7Rpg829ZHu8nFy5Pqdi9U01VYtG9Y0zOG6Vr2z4/S+/3zIyOxiK6cCeYNWOFR9QP87g==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.9.tgz",
+      "integrity": "sha512-YaFBlPGeDasft5IIM+CQAhJAqS3St3nJzDEgsgFixcfZeyGPCd6eJBWzke5piZuZ7CtL656eOSYKk4Ls2C0FRQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/openbsd-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.9.tgz",
+      "integrity": "sha512-1MkgTCuvMGWuqVtAvkpkXFmtL8XhWy+j4jaSO2wxfJtilVCi0ZE37b8uOdMItIHz4I6z1bWWtEX4CJwcKYLcuA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/sunos-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.9.tgz",
+      "integrity": "sha512-WjH4s6hzo00nNezhp3wFIAfmGZ8U7KtrJNlFMRKxiI9mxEK1scOMAaa9i4crUtu+tBr+0IN6JCuAcSBJZfnphw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/win32-arm64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.9.tgz",
+      "integrity": "sha512-mGFrVJHmZiRqmP8xFOc6b84/7xa5y5YvR1x8djzXpJBSv/UsNK6aqec+6JDjConTgvvQefdGhFDAs2DLAds6gQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/win32-ia32": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.9.tgz",
+      "integrity": "sha512-b33gLVU2k11nVx1OhX3C8QQP6UHQK4ZtN56oFWvVXvz2VkDoe6fbG8TOgHFxEvqeqohmRnIHe5A1+HADk4OQww==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@esbuild/win32-x64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.9.tgz",
+      "integrity": "sha512-PPOl1mi6lpLNQxnGoyAfschAodRFYXJ+9fs6WHXz7CSWKbOqiMZsubC+BQsVKuul+3vKLuwTHsS2c2y9EoKwxQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@angular/build/node_modules/@types/node": {
+      "version": "24.9.1",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-24.9.1.tgz",
+      "integrity": "sha512-QoiaXANRkSXK6p0Duvt56W208du4P9Uye9hWLWgGMDTEoKPhuenzNcC4vGUmrNkiOKTlIrBoyNQYNpSwfEZXSg==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "peer": true,
+      "dependencies": {
+        "undici-types": "~7.16.0"
+      }
+    },
+    "node_modules/@angular/build/node_modules/entities": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-6.0.1.tgz",
+      "integrity": "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=0.12"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
+    "node_modules/@angular/build/node_modules/esbuild": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.9.tgz",
+      "integrity": "sha512-CRbODhYyQx3qp7ZEwzxOk4JBqmD/seJrzPa/cGjY1VtIn5E09Oi9/dB4JwctnfZ8Q8iT7rioVv5k/FNT/uf54g==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.25.9",
+        "@esbuild/android-arm": "0.25.9",
+        "@esbuild/android-arm64": "0.25.9",
+        "@esbuild/android-x64": "0.25.9",
+        "@esbuild/darwin-arm64": "0.25.9",
+        "@esbuild/darwin-x64": "0.25.9",
+        "@esbuild/freebsd-arm64": "0.25.9",
+        "@esbuild/freebsd-x64": "0.25.9",
+        "@esbuild/linux-arm": "0.25.9",
+        "@esbuild/linux-arm64": "0.25.9",
+        "@esbuild/linux-ia32": "0.25.9",
+        "@esbuild/linux-loong64": "0.25.9",
+        "@esbuild/linux-mips64el": "0.25.9",
+        "@esbuild/linux-ppc64": "0.25.9",
+        "@esbuild/linux-riscv64": "0.25.9",
+        "@esbuild/linux-s390x": "0.25.9",
+        "@esbuild/linux-x64": "0.25.9",
+        "@esbuild/netbsd-arm64": "0.25.9",
+        "@esbuild/netbsd-x64": "0.25.9",
+        "@esbuild/openbsd-arm64": "0.25.9",
+        "@esbuild/openbsd-x64": "0.25.9",
+        "@esbuild/openharmony-arm64": "0.25.9",
+        "@esbuild/sunos-x64": "0.25.9",
+        "@esbuild/win32-arm64": "0.25.9",
+        "@esbuild/win32-ia32": "0.25.9",
+        "@esbuild/win32-x64": "0.25.9"
+      }
+    },
+    "node_modules/@angular/build/node_modules/parse5-html-rewriting-stream": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/parse5-html-rewriting-stream/-/parse5-html-rewriting-stream-8.0.0.tgz",
+      "integrity": "sha512-wzh11mj8KKkno1pZEu+l2EVeWsuKDfR5KNWZOTsslfUX8lPDZx77m9T0kIoAVkFtD1nx6YF8oh4BnPHvxMtNMw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@angular-devkit/core": "20.1.1",
-        "rxjs": "7.8.2"
+        "entities": "^6.0.0",
+        "parse5": "^8.0.0",
+        "parse5-sax-parser": "^8.0.0"
       },
+      "funding": {
+        "url": "https://github.com/inikulin/parse5?sponsor=1"
+      }
+    },
+    "node_modules/@angular/build/node_modules/parse5-sax-parser": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/parse5-sax-parser/-/parse5-sax-parser-8.0.0.tgz",
+      "integrity": "sha512-/dQ8UzHZwnrzs3EvDj6IkKrD/jIZyTlB+8XrHJvcjNgRdmWruNdN9i9RK/JtxakmlUdPwKubKPTCqvbTgzGhrw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "parse5": "^8.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/inikulin/parse5?sponsor=1"
+      }
+    },
+    "node_modules/@angular/build/node_modules/picomatch": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
+      "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
+      "dev": true,
+      "license": "MIT",
       "engines": {
-        "node": "^20.19.0 || ^22.12.0 || >=24.0.0",
-        "npm": "^6.11.0 || ^7.5.6 || >=8.0.0",
-        "yarn": ">= 1.13.0"
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
       }
     },
     "node_modules/@angular/build/node_modules/vite": {
-      "version": "7.0.0",
-      "resolved": "https://registry.npmjs.org/vite/-/vite-7.0.0.tgz",
-      "integrity": "sha512-ixXJB1YRgDIw2OszKQS9WxGHKwLdCsbQNkpJN171udl6szi/rIySHL6/Os3s2+oE4P/FLD4dxg4mD7Wust+u5g==",
+      "version": "7.1.5",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-7.1.5.tgz",
+      "integrity": "sha512-4cKBO9wR75r0BeIWWWId9XK9Lj6La5X846Zw9dFfzMRw38IlTk2iCcUt6hsyiDRcPidc55ZParFYDXi0nXOeLQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "esbuild": "^0.25.0",
-        "fdir": "^6.4.6",
-        "picomatch": "^4.0.2",
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3",
         "postcss": "^8.5.6",
-        "rollup": "^4.40.0",
-        "tinyglobby": "^0.2.14"
+        "rollup": "^4.43.0",
+        "tinyglobby": "^0.2.15"
       },
       "bin": {
         "vite": "bin/vite.js"
@@ -1044,6 +2159,23 @@
         }
       }
     },
+    "node_modules/@angular/build/node_modules/vite/node_modules/tinyglobby": {
+      "version": "0.2.15",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
+      "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
     "node_modules/@angular/cdk": {
       "version": "20.1.2",
       "resolved": "https://registry.npmjs.org/@angular/cdk/-/cdk-20.1.2.tgz",
@@ -1060,32 +2192,30 @@
       }
     },
     "node_modules/@angular/cli": {
-      "version": "20.1.6",
-      "resolved": "https://registry.npmjs.org/@angular/cli/-/cli-20.1.6.tgz",
-      "integrity": "sha512-kqncVmYtlDYLwt4l5lFBz4uEnoheMH+teSqAAD/zaDxn41KvpoRLHiEVurQhsNP/GDHxGu+8wg0s4gX3kaFOzg==",
+      "version": "20.3.6",
+      "resolved": "https://registry.npmjs.org/@angular/cli/-/cli-20.3.6.tgz",
+      "integrity": "sha512-1RozAub7Gcl5ES3vBYatIgoMDgujlvySwHARoYT+1VhbYvM0RTt4sn2aDhHxqG0GcyiXR5zISkzJvldaY2nQCQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
-        "@angular-devkit/architect": "0.2001.6",
-        "@angular-devkit/core": "20.1.6",
-        "@angular-devkit/schematics": "20.1.6",
-        "@inquirer/prompts": "7.6.0",
-        "@listr2/prompt-adapter-inquirer": "2.0.22",
-        "@modelcontextprotocol/sdk": "1.13.3",
-        "@schematics/angular": "20.1.6",
+        "@angular-devkit/architect": "0.2003.6",
+        "@angular-devkit/core": "20.3.6",
+        "@angular-devkit/schematics": "20.3.6",
+        "@inquirer/prompts": "7.8.2",
+        "@listr2/prompt-adapter-inquirer": "3.0.1",
+        "@modelcontextprotocol/sdk": "1.17.3",
+        "@schematics/angular": "20.3.6",
         "@yarnpkg/lockfile": "1.1.0",
-        "algoliasearch": "5.32.0",
+        "algoliasearch": "5.35.0",
         "ini": "5.0.0",
         "jsonc-parser": "3.3.1",
-        "listr2": "8.3.3",
-        "npm-package-arg": "12.0.2",
-        "npm-pick-manifest": "10.0.0",
+        "listr2": "9.0.1",
+        "npm-package-arg": "13.0.0",
         "pacote": "21.0.0",
         "resolve": "1.22.10",
         "semver": "7.7.2",
         "yargs": "18.0.0",
-        "zod": "3.25.75"
+        "zod": "3.25.76"
       },
       "bin": {
         "ng": "bin/ng.js"
@@ -1096,35 +2226,19 @@
         "yarn": ">= 1.13.0"
       }
     },
-    "node_modules/@angular/cli/node_modules/@angular-devkit/architect": {
-      "version": "0.2001.6",
-      "resolved": "https://registry.npmjs.org/@angular-devkit/architect/-/architect-0.2001.6.tgz",
-      "integrity": "sha512-CGFDfqPvKw1Ekuk7eSYMdhBv26LiwBrnZEUnrloC8fnuT8G+s46WMj/uH3tTcQ9MHYbhOSAHynNwpnwX71wghg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@angular-devkit/core": "20.1.6",
-        "rxjs": "7.8.2"
-      },
-      "engines": {
-        "node": "^20.19.0 || ^22.12.0 || >=24.0.0",
-        "npm": "^6.11.0 || ^7.5.6 || >=8.0.0",
-        "yarn": ">= 1.13.0"
-      }
-    },
     "node_modules/@angular/cli/node_modules/@angular-devkit/core": {
-      "version": "20.1.6",
-      "resolved": "https://registry.npmjs.org/@angular-devkit/core/-/core-20.1.6.tgz",
-      "integrity": "sha512-Wooe+nTmHOLvveBQWDmSsdKg39re5BUMGVkwKlPHTQ/YU9aYshvPEBu1K0l4gSqe3qtqVVAx0HlPb53bEFFa8w==",
+      "version": "20.3.6",
+      "resolved": "https://registry.npmjs.org/@angular-devkit/core/-/core-20.3.6.tgz",
+      "integrity": "sha512-uLRk3865Iz/EO9Zm/mrFfdyoZinJBihXE6HVDYRYjAqsgW14LsD8pkpWy9+LYlOwcH96Ndnev+msxaTJaNXtPg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "ajv": "8.17.1",
         "ajv-formats": "3.0.1",
         "jsonc-parser": "3.3.1",
-        "picomatch": "4.0.2",
+        "picomatch": "4.0.3",
         "rxjs": "7.8.2",
-        "source-map": "0.7.4"
+        "source-map": "0.7.6"
       },
       "engines": {
         "node": "^20.19.0 || ^22.12.0 || >=24.0.0",
@@ -1141,13 +2255,13 @@
       }
     },
     "node_modules/@angular/cli/node_modules/@angular-devkit/schematics": {
-      "version": "20.1.6",
-      "resolved": "https://registry.npmjs.org/@angular-devkit/schematics/-/schematics-20.1.6.tgz",
-      "integrity": "sha512-Maj/yCkn3Qjum2kCYUOYMw8VYh/8725XN8/4cae9VllMwkN5D8jYDvX40qmfgQve2x0x6r3L8rmaIHn8227cHg==",
+      "version": "20.3.6",
+      "resolved": "https://registry.npmjs.org/@angular-devkit/schematics/-/schematics-20.3.6.tgz",
+      "integrity": "sha512-QD7QS1oR0XcZ9ZI4D1c4JjKmSn2up/ocOU2FS1mMO7S5RtAZMsPv4J3r+6ywHA2ev2sRySOQ0D8OYBcEuYX9Jw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@angular-devkit/core": "20.1.6",
+        "@angular-devkit/core": "20.3.6",
         "jsonc-parser": "3.3.1",
         "magic-string": "0.30.17",
         "ora": "8.2.0",
@@ -1160,14 +2274,14 @@
       }
     },
     "node_modules/@angular/cli/node_modules/@schematics/angular": {
-      "version": "20.1.6",
-      "resolved": "https://registry.npmjs.org/@schematics/angular/-/angular-20.1.6.tgz",
-      "integrity": "sha512-1dE+GkpSZbsQxnir/S24g3+pA5sE0XOMxa4Wxhon0dxArP/gH72hsinoVaLDfcQkYOtbbTw/Q8VV41uWBI9eGg==",
+      "version": "20.3.6",
+      "resolved": "https://registry.npmjs.org/@schematics/angular/-/angular-20.3.6.tgz",
+      "integrity": "sha512-YPIEyKPBOyJYlda5fA49kMThzZ4WidomEMDghshux8xidbjDaPWBZdyVPQj3IXyW0teGlUM/TH0TH2weumMZrg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@angular-devkit/core": "20.1.6",
-        "@angular-devkit/schematics": "20.1.6",
+        "@angular-devkit/core": "20.3.6",
+        "@angular-devkit/schematics": "20.3.6",
         "jsonc-parser": "3.3.1"
       },
       "engines": {
@@ -1176,14 +2290,66 @@
         "yarn": ">= 1.13.0"
       }
     },
-    "node_modules/@angular/cli/node_modules/zod": {
-      "version": "3.25.75",
-      "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.75.tgz",
-      "integrity": "sha512-OhpzAmVzabPOL6C3A3gpAifqr9MqihV/Msx3gor2b2kviCgcb+HM9SEOpMWwwNp9MRunWnhtAKUoo0AHhjyPPg==",
+    "node_modules/@angular/cli/node_modules/hosted-git-info": {
+      "version": "9.0.2",
+      "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-9.0.2.tgz",
+      "integrity": "sha512-M422h7o/BR3rmCQ8UHi7cyyMqKltdP9Uo+J2fXK+RSAY+wTcKOIRyhTuKv4qn+DJf3g+PL890AzId5KZpX+CBg==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "lru-cache": "^11.1.0"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/@angular/cli/node_modules/lru-cache": {
+      "version": "11.2.2",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.2.tgz",
+      "integrity": "sha512-F9ODfyqML2coTIsQpSkRHnLSZMtkU8Q+mSfcaIyKwy58u+8k5nvAYeiNhsyMARvzNcXJ9QfWVrcPsC9e9rAxtg==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": "20 || >=22"
+      }
+    },
+    "node_modules/@angular/cli/node_modules/npm-package-arg": {
+      "version": "13.0.0",
+      "resolved": "https://registry.npmjs.org/npm-package-arg/-/npm-package-arg-13.0.0.tgz",
+      "integrity": "sha512-+t2etZAGcB7TbbLHfDwooV9ppB2LhhcT6A+L9cahsf9mEUAoQ6CktLEVvEnpD0N5CkX7zJqnPGaFtoQDy9EkHQ==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "hosted-git-info": "^9.0.0",
+        "proc-log": "^5.0.0",
+        "semver": "^7.3.5",
+        "validate-npm-package-name": "^6.0.0"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/@angular/cli/node_modules/picomatch": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
+      "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
       "dev": true,
       "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
       "funding": {
-        "url": "https://github.com/sponsors/colinhacks"
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/@angular/cli/node_modules/source-map": {
+      "version": "0.7.6",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.7.6.tgz",
+      "integrity": "sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">= 12"
       }
     },
     "node_modules/@angular/common": {
@@ -1191,7 +2357,6 @@
       "resolved": "https://registry.npmjs.org/@angular/common/-/common-20.1.2.tgz",
       "integrity": "sha512-MQYP+4lvw81jBRknNYgIye7N36SD68SADUB7xO+7pF5+KbGundfmZkO29uWCnTBU86C4xU4DshlFVhzFK1lreQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "tslib": "^2.3.0"
       },
@@ -1208,7 +2373,6 @@
       "resolved": "https://registry.npmjs.org/@angular/compiler/-/compiler-20.1.2.tgz",
       "integrity": "sha512-BCYQArXAknOyMB5rgx9yK3p5uYFhgN91Jxo5Fbuso6M+7p1PoxOE4E9XrqQfhpVJOl9hcz7vNFnQ4Oer0R83UQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "tslib": "^2.3.0"
       },
@@ -1221,7 +2385,6 @@
       "resolved": "https://registry.npmjs.org/@angular/compiler-cli/-/compiler-cli-20.1.2.tgz",
       "integrity": "sha512-NMSDavN+CJYvSze6wq7DpbrUA/EqiAD7GQoeJtuOknzUpPlWQmFOoHzTMKW+S34XlNEw+YQT0trv3DKcrE+T/w==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@babel/core": "7.28.0",
         "@jridgewell/sourcemap-codec": "^1.4.14",
@@ -1294,28 +2457,11 @@
         "semver": "bin/semver.js"
       }
     },
-    "node_modules/@angular/compiler-cli/node_modules/@babel/generator": {
-      "version": "7.28.3",
-      "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.3.tgz",
-      "integrity": "sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw==",
-      "license": "MIT",
-      "dependencies": {
-        "@babel/parser": "^7.28.3",
-        "@babel/types": "^7.28.2",
-        "@jridgewell/gen-mapping": "^0.3.12",
-        "@jridgewell/trace-mapping": "^0.3.28",
-        "jsesc": "^3.0.2"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
     "node_modules/@angular/core": {
       "version": "20.1.2",
       "resolved": "https://registry.npmjs.org/@angular/core/-/core-20.1.2.tgz",
       "integrity": "sha512-8jAvpkHoXHSH0HoqNVgPstSMGmC0oaYN93HW7K2rMRxj1Uhtahkeb/7/kfnj7yLi5FDfm98ofOFT4Lxzf2eZXQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "tslib": "^2.3.0"
       },
@@ -1341,7 +2487,6 @@
       "resolved": "https://registry.npmjs.org/@angular/forms/-/forms-20.1.2.tgz",
       "integrity": "sha512-ziOaeN0by1cTCNzwCo/IC2ekFzrM7ehc8uQHMQ6dYprSX45lJmdCsNnn+R0lx68VugvbMhHHO5ieOORf5sEmew==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "tslib": "^2.3.0"
       },
@@ -1419,22 +2564,6 @@
         "url": "https://opencollective.com/babel"
       }
     },
-    "node_modules/@angular/localize/node_modules/@babel/generator": {
-      "version": "7.28.3",
-      "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.3.tgz",
-      "integrity": "sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw==",
-      "license": "MIT",
-      "dependencies": {
-        "@babel/parser": "^7.28.3",
-        "@babel/types": "^7.28.2",
-        "@jridgewell/gen-mapping": "^0.3.12",
-        "@jridgewell/trace-mapping": "^0.3.28",
-        "jsesc": "^3.0.2"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
     "node_modules/@angular/localize/node_modules/convert-source-map": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
@@ -1455,7 +2584,6 @@
       "resolved": "https://registry.npmjs.org/@angular/platform-browser/-/platform-browser-20.1.2.tgz",
       "integrity": "sha512-jsgO4atyh6T3Rt+idHI29ENaq1a4VKfvtTgWf1S0qSCsfMt2kv5AAO+LkL6lYx8TtJu5zjAETiUwSiWUqY1jOg==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "tslib": "^2.3.0"
       },
@@ -1478,7 +2606,6 @@
       "resolved": "https://registry.npmjs.org/@angular/platform-browser-dynamic/-/platform-browser-dynamic-20.1.2.tgz",
       "integrity": "sha512-KssXr0nDZxNjJChdyNFE1wFGaR374qEKBU6mburr2dTauV+jfaL7NrBRzQuTh7GfOOwHnW0uJ4b2dGK6m1tkNw==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "tslib": "^2.3.0"
       },
@@ -1522,7 +2649,6 @@
       "resolved": "https://registry.npmjs.org/@angular/router/-/router-20.1.2.tgz",
       "integrity": "sha512-xMRDARfSgwDZSorrTMtv9Gdb9UtWflwn8LOgmPbj3waXyuGWUbgpoJCD0Mh6necc9fhQ60GbBRG5K2EVVr3ATQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "tslib": "^2.3.0"
       },
@@ -1541,7 +2667,6 @@
       "resolved": "https://registry.npmjs.org/@angular/service-worker/-/service-worker-20.1.2.tgz",
       "integrity": "sha512-NHiKLZR/7AVX5Midia8K9/HPHWFqeFbjsk/DziqffuF+2lQTHgKi6TlrN7soIJoWeDIT/wdYH/1o/vYYwOSPiQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "tslib": "^2.3.0"
       },
@@ -1580,22 +2705,21 @@
       }
     },
     "node_modules/@babel/core": {
-      "version": "7.27.7",
-      "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.27.7.tgz",
-      "integrity": "sha512-BU2f9tlKQ5CAthiMIgpzAh4eDTLWo1mqi9jqE2OxMG0E/OM199VJt2q8BztTxpnSW0i1ymdwLXRJnYzvDM5r2w==",
+      "version": "7.28.3",
+      "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.3.tgz",
+      "integrity": "sha512-yDBHV9kQNcr2/sUr9jghVyz9C3Y5G2zUM2H2lo+9mKv4sFgbA8s8Z9t8D1jiTkGoO/NoIfKMyKWr4s6CN23ZwQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@ampproject/remapping": "^2.2.0",
         "@babel/code-frame": "^7.27.1",
-        "@babel/generator": "^7.27.5",
+        "@babel/generator": "^7.28.3",
         "@babel/helper-compilation-targets": "^7.27.2",
-        "@babel/helper-module-transforms": "^7.27.3",
-        "@babel/helpers": "^7.27.6",
-        "@babel/parser": "^7.27.7",
+        "@babel/helper-module-transforms": "^7.28.3",
+        "@babel/helpers": "^7.28.3",
+        "@babel/parser": "^7.28.3",
         "@babel/template": "^7.27.2",
-        "@babel/traverse": "^7.27.7",
-        "@babel/types": "^7.27.7",
+        "@babel/traverse": "^7.28.3",
+        "@babel/types": "^7.28.2",
         "convert-source-map": "^2.0.0",
         "debug": "^4.1.0",
         "gensync": "^1.0.0-beta.2",
@@ -1626,15 +2750,15 @@
       }
     },
     "node_modules/@babel/generator": {
-      "version": "7.27.5",
-      "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.27.5.tgz",
-      "integrity": "sha512-ZGhA37l0e/g2s1Cnzdix0O3aLYm66eF8aufiVteOgnwxgnRP8GoyMj7VWsgWnQbVKXyge7hqrFh2K2TQM6t1Hw==",
+      "version": "7.28.3",
+      "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.3.tgz",
+      "integrity": "sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw==",
       "license": "MIT",
       "dependencies": {
-        "@babel/parser": "^7.27.5",
-        "@babel/types": "^7.27.3",
-        "@jridgewell/gen-mapping": "^0.3.5",
-        "@jridgewell/trace-mapping": "^0.3.25",
+        "@babel/parser": "^7.28.3",
+        "@babel/types": "^7.28.2",
+        "@jridgewell/gen-mapping": "^0.3.12",
+        "@jridgewell/trace-mapping": "^0.3.28",
         "jsesc": "^3.0.2"
       },
       "engines": {
@@ -2385,15 +3509,15 @@
       }
     },
     "node_modules/@babel/plugin-transform-async-generator-functions": {
-      "version": "7.27.1",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-async-generator-functions/-/plugin-transform-async-generator-functions-7.27.1.tgz",
-      "integrity": "sha512-eST9RrwlpaoJBDHShc+DS2SG4ATTi2MYNb4OxYkf3n+7eb49LWpnS+HSpVfW4x927qQwgk8A2hGNVaajAEw0EA==",
+      "version": "7.28.0",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-async-generator-functions/-/plugin-transform-async-generator-functions-7.28.0.tgz",
+      "integrity": "sha512-BEOdvX4+M765icNPZeidyADIvQ1m1gmunXufXxvRESy/jNNyfovIqUyE7MVgGBjWktCoJlzvFA1To2O4ymIO3Q==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@babel/helper-plugin-utils": "^7.27.1",
         "@babel/helper-remap-async-to-generator": "^7.27.1",
-        "@babel/traverse": "^7.27.1"
+        "@babel/traverse": "^7.28.0"
       },
       "engines": {
         "node": ">=6.9.0"
@@ -2607,6 +3731,23 @@
         "@babel/core": "^7.0.0-0"
       }
     },
+    "node_modules/@babel/plugin-transform-explicit-resource-management": {
+      "version": "7.28.0",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-explicit-resource-management/-/plugin-transform-explicit-resource-management-7.28.0.tgz",
+      "integrity": "sha512-K8nhUcn3f6iB+P3gwCv/no7OdzOZQcKchW6N389V6PD8NUWKZHzndOd9sPDVbMoBsbmjMqlB4L9fm+fEFNVlwQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/helper-plugin-utils": "^7.27.1",
+        "@babel/plugin-transform-destructuring": "^7.28.0"
+      },
+      "engines": {
+        "node": ">=6.9.0"
+      },
+      "peerDependencies": {
+        "@babel/core": "^7.0.0-0"
+      }
+    },
     "node_modules/@babel/plugin-transform-exponentiation-operator": {
       "version": "7.27.1",
       "resolved": "https://registry.npmjs.org/@babel/plugin-transform-exponentiation-operator/-/plugin-transform-exponentiation-operator-7.27.1.tgz",
@@ -3060,17 +4201,17 @@
       }
     },
     "node_modules/@babel/plugin-transform-runtime": {
-      "version": "7.27.4",
-      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-runtime/-/plugin-transform-runtime-7.27.4.tgz",
-      "integrity": "sha512-D68nR5zxU64EUzV8i7T3R5XP0Xhrou/amNnddsRQssx6GrTLdZl1rLxyjtVZBd+v/NVX4AbTPOB5aU8thAZV1A==",
+      "version": "7.28.3",
+      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-runtime/-/plugin-transform-runtime-7.28.3.tgz",
+      "integrity": "sha512-Y6ab1kGqZ0u42Zv/4a7l0l72n9DKP/MKoKWaUSBylrhNZO2prYuqFOLbn5aW5SIFXwSH93yfjbgllL8lxuGKLg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@babel/helper-module-imports": "^7.27.1",
         "@babel/helper-plugin-utils": "^7.27.1",
-        "babel-plugin-polyfill-corejs2": "^0.4.10",
-        "babel-plugin-polyfill-corejs3": "^0.11.0",
-        "babel-plugin-polyfill-regenerator": "^0.6.1",
+        "babel-plugin-polyfill-corejs2": "^0.4.14",
+        "babel-plugin-polyfill-corejs3": "^0.13.0",
+        "babel-plugin-polyfill-regenerator": "^0.6.5",
         "semver": "^6.3.1"
       },
       "engines": {
@@ -3259,13 +4400,13 @@
       }
     },
     "node_modules/@babel/preset-env": {
-      "version": "7.27.2",
-      "resolved": "https://registry.npmjs.org/@babel/preset-env/-/preset-env-7.27.2.tgz",
-      "integrity": "sha512-Ma4zSuYSlGNRlCLO+EAzLnCmJK2vdstgv+n7aUP+/IKZrOfWHOJVdSJtuub8RzHTj3ahD37k5OKJWvzf16TQyQ==",
+      "version": "7.28.3",
+      "resolved": "https://registry.npmjs.org/@babel/preset-env/-/preset-env-7.28.3.tgz",
+      "integrity": "sha512-ROiDcM+GbYVPYBOeCR6uBXKkQpBExLl8k9HO1ygXEyds39j+vCCsjmj7S8GOniZQlEs81QlkdJZe76IpLSiqpg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@babel/compat-data": "^7.27.2",
+        "@babel/compat-data": "^7.28.0",
         "@babel/helper-compilation-targets": "^7.27.2",
         "@babel/helper-plugin-utils": "^7.27.1",
         "@babel/helper-validator-option": "^7.27.1",
@@ -3273,25 +4414,26 @@
         "@babel/plugin-bugfix-safari-class-field-initializer-scope": "^7.27.1",
         "@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression": "^7.27.1",
         "@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining": "^7.27.1",
-        "@babel/plugin-bugfix-v8-static-class-fields-redefine-readonly": "^7.27.1",
+        "@babel/plugin-bugfix-v8-static-class-fields-redefine-readonly": "^7.28.3",
         "@babel/plugin-proposal-private-property-in-object": "7.21.0-placeholder-for-preset-env.2",
         "@babel/plugin-syntax-import-assertions": "^7.27.1",
         "@babel/plugin-syntax-import-attributes": "^7.27.1",
         "@babel/plugin-syntax-unicode-sets-regex": "^7.18.6",
         "@babel/plugin-transform-arrow-functions": "^7.27.1",
-        "@babel/plugin-transform-async-generator-functions": "^7.27.1",
+        "@babel/plugin-transform-async-generator-functions": "^7.28.0",
         "@babel/plugin-transform-async-to-generator": "^7.27.1",
         "@babel/plugin-transform-block-scoped-functions": "^7.27.1",
-        "@babel/plugin-transform-block-scoping": "^7.27.1",
+        "@babel/plugin-transform-block-scoping": "^7.28.0",
         "@babel/plugin-transform-class-properties": "^7.27.1",
-        "@babel/plugin-transform-class-static-block": "^7.27.1",
-        "@babel/plugin-transform-classes": "^7.27.1",
+        "@babel/plugin-transform-class-static-block": "^7.28.3",
+        "@babel/plugin-transform-classes": "^7.28.3",
         "@babel/plugin-transform-computed-properties": "^7.27.1",
-        "@babel/plugin-transform-destructuring": "^7.27.1",
+        "@babel/plugin-transform-destructuring": "^7.28.0",
         "@babel/plugin-transform-dotall-regex": "^7.27.1",
         "@babel/plugin-transform-duplicate-keys": "^7.27.1",
         "@babel/plugin-transform-duplicate-named-capturing-groups-regex": "^7.27.1",
         "@babel/plugin-transform-dynamic-import": "^7.27.1",
+        "@babel/plugin-transform-explicit-resource-management": "^7.28.0",
         "@babel/plugin-transform-exponentiation-operator": "^7.27.1",
         "@babel/plugin-transform-export-namespace-from": "^7.27.1",
         "@babel/plugin-transform-for-of": "^7.27.1",
@@ -3308,15 +4450,15 @@
         "@babel/plugin-transform-new-target": "^7.27.1",
         "@babel/plugin-transform-nullish-coalescing-operator": "^7.27.1",
         "@babel/plugin-transform-numeric-separator": "^7.27.1",
-        "@babel/plugin-transform-object-rest-spread": "^7.27.2",
+        "@babel/plugin-transform-object-rest-spread": "^7.28.0",
         "@babel/plugin-transform-object-super": "^7.27.1",
         "@babel/plugin-transform-optional-catch-binding": "^7.27.1",
         "@babel/plugin-transform-optional-chaining": "^7.27.1",
-        "@babel/plugin-transform-parameters": "^7.27.1",
+        "@babel/plugin-transform-parameters": "^7.27.7",
         "@babel/plugin-transform-private-methods": "^7.27.1",
         "@babel/plugin-transform-private-property-in-object": "^7.27.1",
         "@babel/plugin-transform-property-literals": "^7.27.1",
-        "@babel/plugin-transform-regenerator": "^7.27.1",
+        "@babel/plugin-transform-regenerator": "^7.28.3",
         "@babel/plugin-transform-regexp-modifiers": "^7.27.1",
         "@babel/plugin-transform-reserved-words": "^7.27.1",
         "@babel/plugin-transform-shorthand-properties": "^7.27.1",
@@ -3329,10 +4471,10 @@
         "@babel/plugin-transform-unicode-regex": "^7.27.1",
         "@babel/plugin-transform-unicode-sets-regex": "^7.27.1",
         "@babel/preset-modules": "0.1.6-no-external-plugins",
-        "babel-plugin-polyfill-corejs2": "^0.4.10",
-        "babel-plugin-polyfill-corejs3": "^0.11.0",
-        "babel-plugin-polyfill-regenerator": "^0.6.1",
-        "core-js-compat": "^3.40.0",
+        "babel-plugin-polyfill-corejs2": "^0.4.14",
+        "babel-plugin-polyfill-corejs3": "^0.13.0",
+        "babel-plugin-polyfill-regenerator": "^0.6.5",
+        "core-js-compat": "^3.43.0",
         "semver": "^6.3.1"
       },
       "engines": {
@@ -3388,9 +4530,9 @@
       }
     },
     "node_modules/@babel/runtime": {
-      "version": "7.27.6",
-      "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.27.6.tgz",
-      "integrity": "sha512-vbavdySgbTTrmFE+EsiqUTzlOr5bzlnJtUv9PynGCAKvfQqjIXbvFdumPM/GxMDfyuGMJaJAU6TO4zc1Jf1i8Q==",
+      "version": "7.28.3",
+      "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.28.3.tgz",
+      "integrity": "sha512-9uIQ10o0WGdpP6GDhXcdOJPJuDgFtIDtN/9+ArJQ2NAfAmiuhTQdzkaTGR33v43GYS2UrSA0eX2pPPHoFVvpxA==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -3429,22 +4571,6 @@
         "node": ">=6.9.0"
       }
     },
-    "node_modules/@babel/traverse/node_modules/@babel/generator": {
-      "version": "7.28.3",
-      "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.3.tgz",
-      "integrity": "sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw==",
-      "license": "MIT",
-      "dependencies": {
-        "@babel/parser": "^7.28.3",
-        "@babel/types": "^7.28.2",
-        "@jridgewell/gen-mapping": "^0.3.12",
-        "@jridgewell/trace-mapping": "^0.3.28",
-        "jsesc": "^3.0.2"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
     "node_modules/@babel/types": {
       "version": "7.28.4",
       "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.4.tgz",
@@ -3466,9 +4592,9 @@
       "license": "MIT"
     },
     "node_modules/@bufbuild/protobuf": {
-      "version": "2.9.0",
-      "resolved": "https://registry.npmjs.org/@bufbuild/protobuf/-/protobuf-2.9.0.tgz",
-      "integrity": "sha512-rnJenoStJ8nvmt9Gzye8nkYd6V22xUAnu4086ER7h1zJ508vStko4pMvDeQ446ilDTFpV5wnoc5YS7XvMwwMqA==",
+      "version": "2.10.0",
+      "resolved": "https://registry.npmjs.org/@bufbuild/protobuf/-/protobuf-2.10.0.tgz",
+      "integrity": "sha512-fdRs9PSrBF7QUntpZpq6BTw58fhgGJojgg39m9oFOJGZT+nip9b0so5cYY1oWl5pvemDLr0cPPsH46vwThEbpQ==",
       "dev": true,
       "license": "(Apache-2.0 AND BSD-3-Clause)"
     },
@@ -3507,9 +4633,9 @@
       }
     },
     "node_modules/@emnapi/core": {
-      "version": "1.5.0",
-      "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.5.0.tgz",
-      "integrity": "sha512-sbP8GzB1WDzacS8fgNPpHlp6C9VZe+SJP3F90W9rLemaQj2PzIuTEl1qDOYQf58YIpyjViI24y9aPWCjEzY2cg==",
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.6.0.tgz",
+      "integrity": "sha512-zq/ay+9fNIJJtJiZxdTnXS20PllcYMX3OE23ESc4HK/bdYu3cOWYVhsOhVnXALfU/uqJIxn5NBPd9z4v+SfoSg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -3518,9 +4644,9 @@
       }
     },
     "node_modules/@emnapi/runtime": {
-      "version": "1.5.0",
-      "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.5.0.tgz",
-      "integrity": "sha512-97/BJ3iXHww3djw6hYIfErCZFee7qCtrneuLa20UXFCOTCfBM2cvQHjWJ2EG0s0MtdNwInarqCTz35i4wWXHsQ==",
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.6.0.tgz",
+      "integrity": "sha512-obtUmAHTMjll499P+D9A3axeJFlhdjOWdKUNs/U6QIGT7V5RjcUW1xToAzjvmgTSQhDbYn/NwfTRoJcQ2rNBxA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -3894,6 +5020,23 @@
         "node": ">=18"
       }
     },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.25.9.tgz",
+      "integrity": "sha512-4Xd0xNiMVXKh6Fa7HEJQbrpP3m3DDn43jKxMjxLLRjWnRsfxjORYJlXPO4JNcXtOyfajXorRKY9NkOpTHptErg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/@esbuild/sunos-x64": {
       "version": "0.25.5",
       "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.5.tgz",
@@ -3992,13 +5135,13 @@
       }
     },
     "node_modules/@eslint/config-array": {
-      "version": "0.21.0",
-      "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.0.tgz",
-      "integrity": "sha512-ENIdc4iLu0d93HeYirvKmrzshzofPw6VkZRKQGe9Nv46ZnWUzcF1xV01dcvEg/1wXUR61OmmlSfyeyO7EvjLxQ==",
+      "version": "0.21.1",
+      "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.1.tgz",
+      "integrity": "sha512-aw1gNayWpdI/jSYVgzN5pL0cfzU02GT3NBpeT/DXbx1/1x7ZKxFPd9bwrzygx/qiwIQiJ1sw/zD8qY/kRvlGHA==",
       "dev": true,
       "license": "Apache-2.0",
       "dependencies": {
-        "@eslint/object-schema": "^2.1.6",
+        "@eslint/object-schema": "^2.1.7",
         "debug": "^4.3.1",
         "minimatch": "^3.1.2"
       },
@@ -4031,9 +5174,9 @@
       }
     },
     "node_modules/@eslint/config-helpers": {
-      "version": "0.4.0",
-      "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.4.0.tgz",
-      "integrity": "sha512-WUFvV4WoIwW8Bv0KeKCIIEgdSiFOsulyN0xrMu+7z43q/hkOLXjvb5u7UC9jDxvRzcrbEmuZBX5yJZz1741jog==",
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.4.1.tgz",
+      "integrity": "sha512-csZAzkNhsgwb0I/UAV6/RGFTbiakPCf0ZrGmrIxQpYvGZ00PhTkSnyKNolphgIvmnJeGw6rcGVEXfTzUnFuEvw==",
       "dev": true,
       "license": "Apache-2.0",
       "dependencies": {
@@ -4155,9 +5298,9 @@
       }
     },
     "node_modules/@eslint/js": {
-      "version": "9.37.0",
-      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.37.0.tgz",
-      "integrity": "sha512-jaS+NJ+hximswBG6pjNX0uEJZkrT0zwpVi3BA3vX22aFGjJjmgSTSmPpZCRKmoBL5VY/M6p0xsSJx7rk7sy5gg==",
+      "version": "9.38.0",
+      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.38.0.tgz",
+      "integrity": "sha512-UZ1VpFvXf9J06YG9xQBdnzU+kthors6KjhMAl6f4gH4usHyh31rUf2DLGInT8RFYIReYXNSydgPY0V2LuWgl7A==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -4168,9 +5311,9 @@
       }
     },
     "node_modules/@eslint/object-schema": {
-      "version": "2.1.6",
-      "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.6.tgz",
-      "integrity": "sha512-RBMg5FRL0I0gs51M/guSAj5/e14VQ4tpZnQNWwuDT66P14I43ItmPfIZRhO9fUVIPOAQXU47atlywZ/czoqFPA==",
+      "version": "2.1.7",
+      "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.7.tgz",
+      "integrity": "sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA==",
       "dev": true,
       "license": "Apache-2.0",
       "engines": {
@@ -4279,14 +5422,14 @@
       }
     },
     "node_modules/@inquirer/confirm": {
-      "version": "5.1.13",
-      "resolved": "https://registry.npmjs.org/@inquirer/confirm/-/confirm-5.1.13.tgz",
-      "integrity": "sha512-EkCtvp67ICIVVzjsquUiVSd+V5HRGOGQfsqA4E4vMWhYnB7InUL0pa0TIWt1i+OfP16Gkds8CdIu6yGZwOM1Yw==",
+      "version": "5.1.14",
+      "resolved": "https://registry.npmjs.org/@inquirer/confirm/-/confirm-5.1.14.tgz",
+      "integrity": "sha512-5yR4IBfe0kXe59r1YCTG8WXkUbl7Z35HK87Sw+WUyGD8wNUx7JvY7laahzeytyE1oLn74bQnL7hstctQxisQ8Q==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@inquirer/core": "^10.1.14",
-        "@inquirer/type": "^3.0.7"
+        "@inquirer/core": "^10.1.15",
+        "@inquirer/type": "^3.0.8"
       },
       "engines": {
         "node": ">=18"
@@ -4474,23 +5617,22 @@
       }
     },
     "node_modules/@inquirer/prompts": {
-      "version": "7.6.0",
-      "resolved": "https://registry.npmjs.org/@inquirer/prompts/-/prompts-7.6.0.tgz",
-      "integrity": "sha512-jAhL7tyMxB3Gfwn4HIJ0yuJ5pvcB5maYUcouGcgd/ub79f9MqZ+aVnBtuFf+VC2GTkCBF+R+eo7Vi63w5VZlzw==",
+      "version": "7.8.2",
+      "resolved": "https://registry.npmjs.org/@inquirer/prompts/-/prompts-7.8.2.tgz",
+      "integrity": "sha512-nqhDw2ZcAUrKNPwhjinJny903bRhI0rQhiDz1LksjeRxqa36i3l75+4iXbOy0rlDpLJGxqtgoPavQjmmyS5UJw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
-        "@inquirer/checkbox": "^4.1.9",
-        "@inquirer/confirm": "^5.1.13",
-        "@inquirer/editor": "^4.2.14",
-        "@inquirer/expand": "^4.0.16",
-        "@inquirer/input": "^4.2.0",
-        "@inquirer/number": "^3.0.16",
-        "@inquirer/password": "^4.0.16",
-        "@inquirer/rawlist": "^4.1.4",
-        "@inquirer/search": "^3.0.16",
-        "@inquirer/select": "^4.2.4"
+        "@inquirer/checkbox": "^4.2.1",
+        "@inquirer/confirm": "^5.1.14",
+        "@inquirer/editor": "^4.2.17",
+        "@inquirer/expand": "^4.0.17",
+        "@inquirer/input": "^4.2.1",
+        "@inquirer/number": "^3.0.17",
+        "@inquirer/password": "^4.0.17",
+        "@inquirer/rawlist": "^4.1.5",
+        "@inquirer/search": "^3.1.0",
+        "@inquirer/select": "^4.3.1"
       },
       "engines": {
         "node": ">=18"
@@ -6463,9 +7605,9 @@
       }
     },
     "node_modules/@jsonjoy.com/buffers": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/@jsonjoy.com/buffers/-/buffers-1.2.0.tgz",
-      "integrity": "sha512-6RX+W5a+ZUY/c/7J5s5jK9UinLfJo5oWKh84fb4X0yK2q4WXEWUWZWuEMjvCb1YNUQhEAhUfr5scEGOH7jC4YQ==",
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@jsonjoy.com/buffers/-/buffers-1.2.1.tgz",
+      "integrity": "sha512-12cdlDwX4RUM3QxmUbVJWqZ/mrK6dFQH4Zxq6+r1YXKXYBNgZXndx2qbCJwh3+WWkCSn67IjnlG3XYTvmvYtgA==",
       "dev": true,
       "license": "Apache-2.0",
       "engines": {
@@ -6573,48 +7715,26 @@
       "license": "MIT"
     },
     "node_modules/@listr2/prompt-adapter-inquirer": {
-      "version": "2.0.22",
-      "resolved": "https://registry.npmjs.org/@listr2/prompt-adapter-inquirer/-/prompt-adapter-inquirer-2.0.22.tgz",
-      "integrity": "sha512-hV36ZoY+xKL6pYOt1nPNnkciFkn89KZwqLhAFzJvYysAvL5uBQdiADZx/8bIDXIukzzwG0QlPYolgMzQUtKgpQ==",
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/@listr2/prompt-adapter-inquirer/-/prompt-adapter-inquirer-3.0.1.tgz",
+      "integrity": "sha512-3XFmGwm3u6ioREG+ynAQB7FoxfajgQnMhIu8wC5eo/Lsih4aKDg0VuIMGaOsYn7hJSJagSeaD4K8yfpkEoDEmA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@inquirer/type": "^1.5.5"
+        "@inquirer/type": "^3.0.7"
       },
       "engines": {
-        "node": ">=18.0.0"
+        "node": ">=20.0.0"
       },
       "peerDependencies": {
-        "@inquirer/prompts": ">= 3 < 8"
-      }
-    },
-    "node_modules/@listr2/prompt-adapter-inquirer/node_modules/@inquirer/type": {
-      "version": "1.5.5",
-      "resolved": "https://registry.npmjs.org/@inquirer/type/-/type-1.5.5.tgz",
-      "integrity": "sha512-MzICLu4yS7V8AA61sANROZ9vT1H3ooca5dSmI1FjZkzq7o/koMsRfQSzRtFo+F3Ao4Sf1C0bpLKejpKB/+j6MA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "mute-stream": "^1.0.0"
-      },
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@listr2/prompt-adapter-inquirer/node_modules/mute-stream": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/mute-stream/-/mute-stream-1.0.0.tgz",
-      "integrity": "sha512-avsJQhyd+680gKXyG/sQc0nXaC6rBkPOfyHYcFb9+hdkqQkR9bdnkJ0AMZhke0oesPqIO+mFFJ+IdBc7mst4IA==",
-      "dev": true,
-      "license": "ISC",
-      "engines": {
-        "node": "^14.17.0 || ^16.13.0 || >=18.0.0"
+        "@inquirer/prompts": ">= 3 < 8",
+        "listr2": "9.0.1"
       }
     },
     "node_modules/@lmdb/lmdb-darwin-arm64": {
-      "version": "3.4.1",
-      "resolved": "https://registry.npmjs.org/@lmdb/lmdb-darwin-arm64/-/lmdb-darwin-arm64-3.4.1.tgz",
-      "integrity": "sha512-kKeP5PaY3bFrrF6GY5aDd96iuh1eoS+5CHJ+7hIP629KIEwzGNwbIzBmEX9TAhRJOivSRDTHCIsbu//+NsYKkg==",
+      "version": "3.4.2",
+      "resolved": "https://registry.npmjs.org/@lmdb/lmdb-darwin-arm64/-/lmdb-darwin-arm64-3.4.2.tgz",
+      "integrity": "sha512-NK80WwDoODyPaSazKbzd3NEJ3ygePrkERilZshxBViBARNz21rmediktGHExoj9n5t9+ChlgLlxecdFKLCuCKg==",
       "cpu": [
         "arm64"
       ],
@@ -6626,9 +7746,9 @@
       ]
     },
     "node_modules/@lmdb/lmdb-darwin-x64": {
-      "version": "3.4.1",
-      "resolved": "https://registry.npmjs.org/@lmdb/lmdb-darwin-x64/-/lmdb-darwin-x64-3.4.1.tgz",
-      "integrity": "sha512-9CMB3seTyHs3EOVWdKiB8IIEDBJ3Gq00Tqyi0V7DS3HL90BjM/AkbZGuhzXwPrfeFazR24SKaRrUQF74f+CmWw==",
+      "version": "3.4.2",
+      "resolved": "https://registry.npmjs.org/@lmdb/lmdb-darwin-x64/-/lmdb-darwin-x64-3.4.2.tgz",
+      "integrity": "sha512-zevaowQNmrp3U7Fz1s9pls5aIgpKRsKb3dZWDINtLiozh3jZI9fBrI19lYYBxqdyiIyNdlyiidPnwPShj4aK+w==",
       "cpu": [
         "x64"
       ],
@@ -6640,9 +7760,9 @@
       ]
     },
     "node_modules/@lmdb/lmdb-linux-arm": {
-      "version": "3.4.1",
-      "resolved": "https://registry.npmjs.org/@lmdb/lmdb-linux-arm/-/lmdb-linux-arm-3.4.1.tgz",
-      "integrity": "sha512-1Mi69vU0akHgCI7tF6YbimPaNEKJiBm/p5A+aM8egr0joj27cQmCCOm2mZQ+Ht2BqmCfZaIgQnMg4gFYNMlpCA==",
+      "version": "3.4.2",
+      "resolved": "https://registry.npmjs.org/@lmdb/lmdb-linux-arm/-/lmdb-linux-arm-3.4.2.tgz",
+      "integrity": "sha512-OmHCULY17rkx/RoCoXlzU7LyR8xqrksgdYWwtYa14l/sseezZ8seKWXcogHcjulBddER5NnEFV4L/Jtr2nyxeg==",
       "cpu": [
         "arm"
       ],
@@ -6654,9 +7774,9 @@
       ]
     },
     "node_modules/@lmdb/lmdb-linux-arm64": {
-      "version": "3.4.1",
-      "resolved": "https://registry.npmjs.org/@lmdb/lmdb-linux-arm64/-/lmdb-linux-arm64-3.4.1.tgz",
-      "integrity": "sha512-d0vuXOdoKjHHJYZ/CRWopnkOiUpev+bgBBW+1tXtWsYWUj8uxl9ZmTBEmsL5mjUlpQDrlYiJSrhOU1hg5QWBSw==",
+      "version": "3.4.2",
+      "resolved": "https://registry.npmjs.org/@lmdb/lmdb-linux-arm64/-/lmdb-linux-arm64-3.4.2.tgz",
+      "integrity": "sha512-ZBEfbNZdkneebvZs98Lq30jMY8V9IJzckVeigGivV7nTHJc+89Ctomp1kAIWKlwIG0ovCDrFI448GzFPORANYg==",
       "cpu": [
         "arm64"
       ],
@@ -6668,9 +7788,9 @@
       ]
     },
     "node_modules/@lmdb/lmdb-linux-x64": {
-      "version": "3.4.1",
-      "resolved": "https://registry.npmjs.org/@lmdb/lmdb-linux-x64/-/lmdb-linux-x64-3.4.1.tgz",
-      "integrity": "sha512-00RbEpvfnyPodlICiGFuiOmyvWaL9nzCRSqZz82BVFsGTiSQnnF0gpD1C8tO6OvtptELbtRuM7BS9f97LcowZw==",
+      "version": "3.4.2",
+      "resolved": "https://registry.npmjs.org/@lmdb/lmdb-linux-x64/-/lmdb-linux-x64-3.4.2.tgz",
+      "integrity": "sha512-vL9nM17C77lohPYE4YaAQvfZCSVJSryE4fXdi8M7uWPBnU+9DJabgKVAeyDb84ZM2vcFseoBE4/AagVtJeRE7g==",
       "cpu": [
         "x64"
       ],
@@ -6682,9 +7802,9 @@
       ]
     },
     "node_modules/@lmdb/lmdb-win32-arm64": {
-      "version": "3.4.1",
-      "resolved": "https://registry.npmjs.org/@lmdb/lmdb-win32-arm64/-/lmdb-win32-arm64-3.4.1.tgz",
-      "integrity": "sha512-4h8tm3i1ODf+28UyqQZLP7c2jmRM26AyEEyYp994B4GiBdGvGAsYUu3oiHANYK9xFpvLuFzyGeqFm1kdNC0D1A==",
+      "version": "3.4.2",
+      "resolved": "https://registry.npmjs.org/@lmdb/lmdb-win32-arm64/-/lmdb-win32-arm64-3.4.2.tgz",
+      "integrity": "sha512-SXWjdBfNDze4ZPeLtYIzsIeDJDJ/SdsA0pEXcUBayUIMO0FQBHfVZZyHXQjjHr4cvOAzANBgIiqaXRwfMhzmLw==",
       "cpu": [
         "arm64"
       ],
@@ -6696,9 +7816,9 @@
       ]
     },
     "node_modules/@lmdb/lmdb-win32-x64": {
-      "version": "3.4.1",
-      "resolved": "https://registry.npmjs.org/@lmdb/lmdb-win32-x64/-/lmdb-win32-x64-3.4.1.tgz",
-      "integrity": "sha512-HqqKIhTbq6piJhkJpTTf3w1m/CgrmwXRAL9R9j7Ru5xdZSeO7Mg4AWiBC9B00uXR+LvVZKtUyRMVZfhmIZztmQ==",
+      "version": "3.4.2",
+      "resolved": "https://registry.npmjs.org/@lmdb/lmdb-win32-x64/-/lmdb-win32-x64-3.4.2.tgz",
+      "integrity": "sha512-IY+r3bxKW6Q6sIPiMC0L533DEfRJSXibjSI3Ft/w9Q8KQBNqEIvUFXt+09wV8S5BRk0a8uSF19YWxuRwEfI90g==",
       "cpu": [
         "x64"
       ],
@@ -6716,6 +7836,7 @@
       "dev": true,
       "license": "BSD-3-Clause",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "detect-libc": "^2.0.0",
         "https-proxy-agent": "^5.0.0",
@@ -6737,7 +7858,8 @@
       "integrity": "sha512-nne9/IiQ/hzIhY6pdDnbBtz7DjPTKrY00P/zvPSm5pOFkl6xuGrGnXn/VtTNNfNtAfZ9/1RtehkszU9qcTii0Q==",
       "dev": true,
       "license": "ISC",
-      "optional": true
+      "optional": true,
+      "peer": true
     },
     "node_modules/@mapbox/node-pre-gyp/node_modules/agent-base": {
       "version": "6.0.2",
@@ -6746,6 +7868,7 @@
       "dev": true,
       "license": "MIT",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "debug": "4"
       },
@@ -6760,6 +7883,7 @@
       "dev": true,
       "license": "MIT",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "agent-base": "6",
         "debug": "4"
@@ -6775,6 +7899,7 @@
       "dev": true,
       "license": "MIT",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "semver": "^6.0.0"
       },
@@ -6792,6 +7917,7 @@
       "dev": true,
       "license": "ISC",
       "optional": true,
+      "peer": true,
       "bin": {
         "semver": "bin/semver.js"
       }
@@ -6803,6 +7929,7 @@
       "dev": true,
       "license": "ISC",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "abbrev": "1"
       },
@@ -6845,9 +7972,9 @@
       }
     },
     "node_modules/@modelcontextprotocol/sdk": {
-      "version": "1.13.3",
-      "resolved": "https://registry.npmjs.org/@modelcontextprotocol/sdk/-/sdk-1.13.3.tgz",
-      "integrity": "sha512-bGwA78F/U5G2jrnsdRkPY3IwIwZeWUEfb5o764b79lb0rJmMT76TLwKhdNZOWakOQtedYefwIR4emisEMvInKA==",
+      "version": "1.17.3",
+      "resolved": "https://registry.npmjs.org/@modelcontextprotocol/sdk/-/sdk-1.17.3.tgz",
+      "integrity": "sha512-JPwUKWSsbzx+DLFznf/QZ32Qa+ptfbUlHhRLrBQBAFu9iI1iYvizM4p+zhhRDceSsPutXp4z+R/HPVphlIiclg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -7053,7 +8180,6 @@
       "integrity": "sha512-YEdHA/rXlydI+ecmsidM0imAhAgyN+fSCOWRJtm72Kx10J6kS2tN1/Zah/hf9C9Msj9OOl0w22aOo7/Sy0qRqg==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@module-federation/bridge-react-webpack-plugin": "0.17.1",
         "@module-federation/cli": "0.17.1",
@@ -7134,15 +8260,15 @@
       }
     },
     "node_modules/@module-federation/node": {
-      "version": "2.7.18",
-      "resolved": "https://registry.npmjs.org/@module-federation/node/-/node-2.7.18.tgz",
-      "integrity": "sha512-DcZeTlDCOntWOwCslqyHZviP1Lrgh/GbodclQvkhKkQqR456i5sLSz5ALLqLi0RJGcU7VZFUSJYg+fDa563QUg==",
+      "version": "2.7.19",
+      "resolved": "https://registry.npmjs.org/@module-federation/node/-/node-2.7.19.tgz",
+      "integrity": "sha512-eheH/fLxtjKlJlPk9QjJgcI/JDitbjSSe6Mm0tm0FXw4OPP7LETc2uCr4qSBymS5WVWwOtBCzq9lACbJHYw0rA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@module-federation/enhanced": "0.20.0",
-        "@module-federation/runtime": "0.20.0",
-        "@module-federation/sdk": "0.20.0",
+        "@module-federation/enhanced": "0.21.0",
+        "@module-federation/runtime": "0.21.0",
+        "@module-federation/sdk": "0.21.0",
         "btoa": "1.2.1",
         "encoding": "^0.1.13",
         "node-fetch": "2.7.0"
@@ -7165,27 +8291,27 @@
       }
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/bridge-react-webpack-plugin": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/bridge-react-webpack-plugin/-/bridge-react-webpack-plugin-0.20.0.tgz",
-      "integrity": "sha512-9646830ZQqslgpdoil/1AYHuRH9I1fkpBeMWtiqzkTZl5+tSxJtghlzaNVRwC2QZiuH4lXgo/SNGpomGyPC+jA==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/bridge-react-webpack-plugin/-/bridge-react-webpack-plugin-0.21.0.tgz",
+      "integrity": "sha512-k4C55EgRhvnErMztKAGakIFCidAT9f/5ErjDBJtcYCcrycFpEltIbQ5922+dPMuekYQGI8eBYLM34814kGI/6w==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@module-federation/sdk": "0.20.0",
+        "@module-federation/sdk": "0.21.0",
         "@types/semver": "7.5.8",
         "semver": "7.6.3"
       }
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/cli": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/cli/-/cli-0.20.0.tgz",
-      "integrity": "sha512-/uNb1SUX50YMzrcXTbvt+wji/wTRTIZDnwrMTl6kG1R/9PfPN65ROzbrCh6jwjGdOHehU21MjwKqHYC+7TVlUQ==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/cli/-/cli-0.21.0.tgz",
+      "integrity": "sha512-nLsYHsD3CsocUwe58MZnFD2XvqS1C9sJW60kH3+Y2hYVFW9EkhPRuJGuoV2DS2EZlP22UfnZphqVZ08nwurLZw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@modern-js/node-bundle-require": "2.68.2",
-        "@module-federation/dts-plugin": "0.20.0",
-        "@module-federation/sdk": "0.20.0",
+        "@module-federation/dts-plugin": "0.21.0",
+        "@module-federation/sdk": "0.21.0",
         "chalk": "3.0.0",
         "commander": "11.1.0"
       },
@@ -7197,14 +8323,14 @@
       }
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/data-prefetch": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/data-prefetch/-/data-prefetch-0.20.0.tgz",
-      "integrity": "sha512-bwx44R/xPUMPbv0NoVsnIeUTzEWFpJ8WcF3T+jv1AbPfTkRoP14tasi4H0XzSKtA/g9bu9ZeU4Z5C35RyGFxWQ==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/data-prefetch/-/data-prefetch-0.21.0.tgz",
+      "integrity": "sha512-cwvD55fqTx+XFlYQ/G+rOhWN0Jbd37PaVdyKPLtgYHQ+7DUya2H3xDH1RbSkDKw3esAn91NZq00nXEfL8ccvKA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@module-federation/runtime": "0.20.0",
-        "@module-federation/sdk": "0.20.0",
+        "@module-federation/runtime": "0.21.0",
+        "@module-federation/sdk": "0.21.0",
         "fs-extra": "9.1.0"
       },
       "peerDependencies": {
@@ -7213,16 +8339,16 @@
       }
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/dts-plugin": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/dts-plugin/-/dts-plugin-0.20.0.tgz",
-      "integrity": "sha512-xa4igYIM3VOFPUsrmGOMkNEdlgl9m95gVyqjxOvsXQuNk0SWFEEWAlBUCbutn5EQCwfK8irCjZHd4ZsFiBa2qw==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/dts-plugin/-/dts-plugin-0.21.0.tgz",
+      "integrity": "sha512-G191VJqnKijul0nMLAvzF8LpeXVOqeJMLVRAQXoiL1P2/Y1C5OctKGq7QevA93vhLu79Ck2OGr2pOd3yH9NvnQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@module-federation/error-codes": "0.20.0",
-        "@module-federation/managers": "0.20.0",
-        "@module-federation/sdk": "0.20.0",
-        "@module-federation/third-party-dts-extractor": "0.20.0",
+        "@module-federation/error-codes": "0.21.0",
+        "@module-federation/managers": "0.21.0",
+        "@module-federation/sdk": "0.21.0",
+        "@module-federation/third-party-dts-extractor": "0.21.0",
         "adm-zip": "^0.5.10",
         "ansi-colors": "^4.1.3",
         "axios": "^1.12.0",
@@ -7247,23 +8373,23 @@
       }
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/enhanced": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/enhanced/-/enhanced-0.20.0.tgz",
-      "integrity": "sha512-BVi+YIfgNWG1+KvSTTpLU8mhMbwI9ndlsIv7Hb64VhI/rdo5y9ZI6s3s+9PxXGB/sVcujH4d/uyb4VMl1/5KQg==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/enhanced/-/enhanced-0.21.0.tgz",
+      "integrity": "sha512-fpeERj4ymaiY52hyLNLdOqMjOBvvmd3rcbBTyoss06B4XagW+RcDrQ+DImZot259Vbac6AxA1J4V1swFEmYEpA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@module-federation/bridge-react-webpack-plugin": "0.20.0",
-        "@module-federation/cli": "0.20.0",
-        "@module-federation/data-prefetch": "0.20.0",
-        "@module-federation/dts-plugin": "0.20.0",
-        "@module-federation/error-codes": "0.20.0",
-        "@module-federation/inject-external-runtime-core-plugin": "0.20.0",
-        "@module-federation/managers": "0.20.0",
-        "@module-federation/manifest": "0.20.0",
-        "@module-federation/rspack": "0.20.0",
-        "@module-federation/runtime-tools": "0.20.0",
-        "@module-federation/sdk": "0.20.0",
+        "@module-federation/bridge-react-webpack-plugin": "0.21.0",
+        "@module-federation/cli": "0.21.0",
+        "@module-federation/data-prefetch": "0.21.0",
+        "@module-federation/dts-plugin": "0.21.0",
+        "@module-federation/error-codes": "0.21.0",
+        "@module-federation/inject-external-runtime-core-plugin": "0.21.0",
+        "@module-federation/managers": "0.21.0",
+        "@module-federation/manifest": "0.21.0",
+        "@module-federation/rspack": "0.21.0",
+        "@module-federation/runtime-tools": "0.21.0",
+        "@module-federation/sdk": "0.21.0",
         "btoa": "^1.2.1",
         "schema-utils": "^4.3.0",
         "upath": "2.0.1"
@@ -7289,62 +8415,62 @@
       }
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/error-codes": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/error-codes/-/error-codes-0.20.0.tgz",
-      "integrity": "sha512-pwKqIFXHG72AaXjtptZb+l5VOO3O7JQMVZ4txFhBH4H/BMu7o1LRBONllTisVmojLHOC/RQpBrxXSGrC64LC4w==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/error-codes/-/error-codes-0.21.0.tgz",
+      "integrity": "sha512-jZLvq4bkDUz9Qt5N+vKRGdJ1qSEt0W637xhAGgoaTNXY1aCoS99zeqWZzt1RCA6BAJjwVC+wz60VLMtZ+6ZQYw==",
       "dev": true,
       "license": "MIT"
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/inject-external-runtime-core-plugin": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/inject-external-runtime-core-plugin/-/inject-external-runtime-core-plugin-0.20.0.tgz",
-      "integrity": "sha512-9hHCDtG/r7eucUq0OyIwi9BWQtccvb5ALEWvzbsckxLqTHNr4SQI1rNtBaHOgxhUYEBPlPI41BdhsuKhC9yIvQ==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/inject-external-runtime-core-plugin/-/inject-external-runtime-core-plugin-0.21.0.tgz",
+      "integrity": "sha512-geluIyX4VwYGzmjqLpv9HcpoJ1lOxbvDBpRLQmd+m3UDuJWyY+yXuumg64CC7TUWD3DjZqiOLOCTd5XuLIQ5Nw==",
       "dev": true,
       "license": "MIT",
       "peerDependencies": {
-        "@module-federation/runtime-tools": "0.20.0"
+        "@module-federation/runtime-tools": "0.21.0"
       }
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/managers": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/managers/-/managers-0.20.0.tgz",
-      "integrity": "sha512-7qqqpUE8DeSQ/fwBJPLXd4uNdkVgin8HIuvumZ7zdbuwbYrCagu/VXSan9XOX4kapwkkt2WbYDSUN9lK+zGQkA==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/managers/-/managers-0.21.0.tgz",
+      "integrity": "sha512-9YJ7dro1sJeAz6wsZrhtM/K/I9s3CWaQpqcFYUYj4ZNMpVeCNpxKRRbewd/wBKel6T/wMNvAGN5iiJn54TGKSQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@module-federation/sdk": "0.20.0",
+        "@module-federation/sdk": "0.21.0",
         "find-pkg": "2.0.0",
         "fs-extra": "9.1.0"
       }
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/manifest": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/manifest/-/manifest-0.20.0.tgz",
-      "integrity": "sha512-dTyuf9US4aKdKR5IjLbQrRiQHEh5AzGp4IBAs6rjjMS2DcJwcj0l8RXO1nLCnfpnDGxIoBhPLyHNvin86SjYFA==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/manifest/-/manifest-0.21.0.tgz",
+      "integrity": "sha512-m2evrpyO9OPF4ul/qHD5P76CfBgFpEDsNAorddNgDOZAjI75lqD4DX/R0gyuTXoSOPz0vFbLLWLy2adze5xRTA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@module-federation/dts-plugin": "0.20.0",
-        "@module-federation/managers": "0.20.0",
-        "@module-federation/sdk": "0.20.0",
+        "@module-federation/dts-plugin": "0.21.0",
+        "@module-federation/managers": "0.21.0",
+        "@module-federation/sdk": "0.21.0",
         "chalk": "3.0.0",
         "find-pkg": "2.0.0"
       }
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/rspack": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/rspack/-/rspack-0.20.0.tgz",
-      "integrity": "sha512-ZO207cj4wi/4qdox+gab3Clkb8w5UTjdp0fZmMPXbT79z/1C8c0UbMBZbXii6e31+C5ylvmxZsgP+vP8F4v19w==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/rspack/-/rspack-0.21.0.tgz",
+      "integrity": "sha512-XQtYSWZxqgpIJg0qEDG5gyQ3WPFrIWnLvA0feQ51Ll8Ubv6sVo+se+gycLbZxJ/rD7D93y523tiiNWjdER7vCg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@module-federation/bridge-react-webpack-plugin": "0.20.0",
-        "@module-federation/dts-plugin": "0.20.0",
-        "@module-federation/inject-external-runtime-core-plugin": "0.20.0",
-        "@module-federation/managers": "0.20.0",
-        "@module-federation/manifest": "0.20.0",
-        "@module-federation/runtime-tools": "0.20.0",
-        "@module-federation/sdk": "0.20.0",
+        "@module-federation/bridge-react-webpack-plugin": "0.21.0",
+        "@module-federation/dts-plugin": "0.21.0",
+        "@module-federation/inject-external-runtime-core-plugin": "0.21.0",
+        "@module-federation/managers": "0.21.0",
+        "@module-federation/manifest": "0.21.0",
+        "@module-federation/runtime-tools": "0.21.0",
+        "@module-federation/sdk": "0.21.0",
         "btoa": "1.2.1"
       },
       "peerDependencies": {
@@ -7362,51 +8488,50 @@
       }
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/runtime": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/runtime/-/runtime-0.20.0.tgz",
-      "integrity": "sha512-9vHE27aLCWbvzUfYWCTCsNbx4IQ5MtK3f340s4swQofTKj0Qv5dJ6gRIwmHk3DqvH5/1FZoQi3FYMCmrThiGrg==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/runtime/-/runtime-0.21.0.tgz",
+      "integrity": "sha512-fl31G2x/+g8/KyMFAlxM8825inuAZu4FQiIg9X2wVKRD1Yx8svg12likGBiorVofO2gBTY7KQ+Nbc6Az90JKQQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@module-federation/error-codes": "0.20.0",
-        "@module-federation/runtime-core": "0.20.0",
-        "@module-federation/sdk": "0.20.0"
+        "@module-federation/error-codes": "0.21.0",
+        "@module-federation/runtime-core": "0.21.0",
+        "@module-federation/sdk": "0.21.0"
       }
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/runtime-core": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/runtime-core/-/runtime-core-0.20.0.tgz",
-      "integrity": "sha512-M/0F/Ed6o1eCC5gKW3V3QtbxeNZ1w0Y7r6NKNacnwKKC12Nn7Ty9Rg1Kjw2B13EUqP8Qs2Y2IwmBEApy7cFLMw==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/runtime-core/-/runtime-core-0.21.0.tgz",
+      "integrity": "sha512-qIvhfON6TQxbybZFNJzJZ0woi0kXaTWIavPdcUxi41LpxxB5Ax1voqpY5NXE2Zq0Uek88b2OgDgXyvIuKM50XQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@module-federation/error-codes": "0.20.0",
-        "@module-federation/sdk": "0.20.0"
+        "@module-federation/error-codes": "0.21.0",
+        "@module-federation/sdk": "0.21.0"
       }
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/runtime-tools": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/runtime-tools/-/runtime-tools-0.20.0.tgz",
-      "integrity": "sha512-5NimrYQyYr8hBl48YVU+w6bzl9uWDKNq3IEqYDgYljTYlupbVqsH2MJTf2A+c95nuCycjHS0vp5B3rnJ3Kdotg==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/runtime-tools/-/runtime-tools-0.21.0.tgz",
+      "integrity": "sha512-XOjd5yLUTD12ay35rgSEhB9JIqxDZuC1OB6/aNyHf7IWPUNB7s4XZ2JlGn1xW8c0Asq1VRm15DF+BXmyDf+XnQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
-        "@module-federation/runtime": "0.20.0",
-        "@module-federation/webpack-bundler-runtime": "0.20.0"
+        "@module-federation/runtime": "0.21.0",
+        "@module-federation/webpack-bundler-runtime": "0.21.0"
       }
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/sdk": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/sdk/-/sdk-0.20.0.tgz",
-      "integrity": "sha512-bBFGA07PpfioJLY0DITVe+szGwLtFad+8R4rb5bPFKCZPZsKqLKwMB9tSsdHeieFPSc+1v20s6wq+R1DiWe56Q==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/sdk/-/sdk-0.21.0.tgz",
+      "integrity": "sha512-tWQ2j+zH6hLaERcie186gwAULyWI/js4WSyzTF2d52ti8vKf+357S7IL4/96+AaTrvwP50NWeR8Igc176kaGTA==",
       "dev": true,
       "license": "MIT"
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/third-party-dts-extractor": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/third-party-dts-extractor/-/third-party-dts-extractor-0.20.0.tgz",
-      "integrity": "sha512-8XqjnxrFVPxKpTxRYV8kzkBoltxwakuh3eemB0DO0IjE4K/D0OMKUB68zCWnXAeR53j719YegijwF5GmFGx8qA==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/third-party-dts-extractor/-/third-party-dts-extractor-0.21.0.tgz",
+      "integrity": "sha512-8aWNbWs0IcuAhf/5321SiIFMAMIFQLE7ttlsOw6rb1U7S9u7LzGHR5eNPhKA7BT9OZUg/1aIa8/Ax2hAhj2VNw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -7416,14 +8541,14 @@
       }
     },
     "node_modules/@module-federation/node/node_modules/@module-federation/webpack-bundler-runtime": {
-      "version": "0.20.0",
-      "resolved": "https://registry.npmjs.org/@module-federation/webpack-bundler-runtime/-/webpack-bundler-runtime-0.20.0.tgz",
-      "integrity": "sha512-TB0v5FRjfpL5fR8O5L4L3FTKJsb4EsflK8aNkdrJ46Tm/MR+PvL4SEx/AXpnsY+g/zkGRkiz10vwF0/RgMh6fQ==",
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/@module-federation/webpack-bundler-runtime/-/webpack-bundler-runtime-0.21.0.tgz",
+      "integrity": "sha512-kxXf7TB0CRdtqsXUGhoV/e5+1gZpcjMHt1C6ZZWhLCHZTSpESqPHm2GUk41yzKj/0qn/QyDJ39NGKjALWLws4A==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@module-federation/runtime": "0.20.0",
-        "@module-federation/sdk": "0.20.0"
+        "@module-federation/runtime": "0.21.0",
+        "@module-federation/sdk": "0.21.0"
       }
     },
     "node_modules/@module-federation/node/node_modules/accepts": {
@@ -7638,7 +8763,6 @@
       "integrity": "sha512-4kr6zTFFwGywJx6whBtxsc84V+COAuuBpEdEbPZN//YLXhNB0iz2IGsy9r9wDl+06h84bD+3dQ05l9euRLgXzQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@module-federation/runtime": "0.17.1",
         "@module-federation/webpack-bundler-runtime": "0.17.1"
@@ -8211,7 +9335,6 @@
       "resolved": "https://registry.npmjs.org/@ngrx/signals/-/signals-20.0.1.tgz",
       "integrity": "sha512-7YYPH4nTkmLEgibJnwi527toEm3tsnlCzp5AzT9osS8JxN9cHxkG6iQ7fzhw9N4bTt+8wyUZb7PF0YLFYD2RHA==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "tslib": "^2.3.0"
       },
@@ -8230,7 +9353,6 @@
       "resolved": "https://registry.npmjs.org/@ngrx/store/-/store-20.0.1.tgz",
       "integrity": "sha512-SWIHKe9lBoNf4rOklaWbCRAz8ie1Duf1iL4SMe6BipqhdUfJ/pEbcz3xMQUIlv1CciHhRgMJFTzFrDxamYHknQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "tslib": "^2.0.0"
       },
@@ -8254,9 +9376,9 @@
       }
     },
     "node_modules/@ngtools/webpack": {
-      "version": "20.1.1",
-      "resolved": "https://registry.npmjs.org/@ngtools/webpack/-/webpack-20.1.1.tgz",
-      "integrity": "sha512-HBF/bQyDjGlzv2uOXlwjrLFxdERynen7JuX3ZgI1vijc41aBX/nyMNa4MsKiOwNOQmpHGJU6qn6/gAN4DhocKQ==",
+      "version": "20.3.6",
+      "resolved": "https://registry.npmjs.org/@ngtools/webpack/-/webpack-20.3.6.tgz",
+      "integrity": "sha512-PM3ODWdiYmLfUueJR+jpffuX1qwM6kyEOg/SE9+kfSSyu9dRFt3k5LoAHAzH+gbs1JsvztmG/wfkE/ZlexteKQ==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -8266,7 +9388,7 @@
       },
       "peerDependencies": {
         "@angular/compiler-cli": "^20.0.0",
-        "typescript": ">=5.8 <5.9",
+        "typescript": ">=5.8 <6.0",
         "webpack": "^5.54.0"
       }
     },
@@ -10884,9 +12006,9 @@
       "license": "MIT"
     },
     "node_modules/@rollup/rollup-android-arm-eabi": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.44.1.tgz",
-      "integrity": "sha512-JAcBr1+fgqx20m7Fwe1DxPUl/hPkee6jA6Pl7n1v2EFiktAHenTaXl5aIFjUIEsfn9w3HE4gK1lEgNGMzBDs1w==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.52.3.tgz",
+      "integrity": "sha512-h6cqHGZ6VdnwliFG1NXvMPTy/9PS3h8oLh7ImwR+kl+oYnQizgjxsONmmPSb2C66RksfkfIxEVtDSEcJiO0tqw==",
       "cpu": [
         "arm"
       ],
@@ -10898,9 +12020,9 @@
       ]
     },
     "node_modules/@rollup/rollup-android-arm64": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.44.1.tgz",
-      "integrity": "sha512-RurZetXqTu4p+G0ChbnkwBuAtwAbIwJkycw1n6GvlGlBuS4u5qlr5opix8cBAYFJgaY05TWtM+LaoFggUmbZEQ==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.52.3.tgz",
+      "integrity": "sha512-wd+u7SLT/u6knklV/ifG7gr5Qy4GUbH2hMWcDauPFJzmCZUAJ8L2bTkVXC2niOIxp8lk3iH/QX8kSrUxVZrOVw==",
       "cpu": [
         "arm64"
       ],
@@ -10912,9 +12034,9 @@
       ]
     },
     "node_modules/@rollup/rollup-darwin-arm64": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.44.1.tgz",
-      "integrity": "sha512-fM/xPesi7g2M7chk37LOnmnSTHLG/v2ggWqKj3CCA1rMA4mm5KVBT1fNoswbo1JhPuNNZrVwpTvlCVggv8A2zg==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.52.3.tgz",
+      "integrity": "sha512-lj9ViATR1SsqycwFkJCtYfQTheBdvlWJqzqxwc9f2qrcVrQaF/gCuBRTiTolkRWS6KvNxSk4KHZWG7tDktLgjg==",
       "cpu": [
         "arm64"
       ],
@@ -10926,9 +12048,9 @@
       ]
     },
     "node_modules/@rollup/rollup-darwin-x64": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.44.1.tgz",
-      "integrity": "sha512-gDnWk57urJrkrHQ2WVx9TSVTH7lSlU7E3AFqiko+bgjlh78aJ88/3nycMax52VIVjIm3ObXnDL2H00e/xzoipw==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.52.3.tgz",
+      "integrity": "sha512-+Dyo7O1KUmIsbzx1l+4V4tvEVnVQqMOIYtrxK7ncLSknl1xnMHLgn7gddJVrYPNZfEB8CIi3hK8gq8bDhb3h5A==",
       "cpu": [
         "x64"
       ],
@@ -10940,9 +12062,9 @@
       ]
     },
     "node_modules/@rollup/rollup-freebsd-arm64": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.44.1.tgz",
-      "integrity": "sha512-wnFQmJ/zPThM5zEGcnDcCJeYJgtSLjh1d//WuHzhf6zT3Md1BvvhJnWoy+HECKu2bMxaIcfWiu3bJgx6z4g2XA==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.52.3.tgz",
+      "integrity": "sha512-u9Xg2FavYbD30g3DSfNhxgNrxhi6xVG4Y6i9Ur1C7xUuGDW3banRbXj+qgnIrwRN4KeJ396jchwy9bCIzbyBEQ==",
       "cpu": [
         "arm64"
       ],
@@ -10954,9 +12076,9 @@
       ]
     },
     "node_modules/@rollup/rollup-freebsd-x64": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.44.1.tgz",
-      "integrity": "sha512-uBmIxoJ4493YATvU2c0upGz87f99e3wop7TJgOA/bXMFd2SvKCI7xkxY/5k50bv7J6dw1SXT4MQBQSLn8Bb/Uw==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.52.3.tgz",
+      "integrity": "sha512-5M8kyi/OX96wtD5qJR89a/3x5x8x5inXBZO04JWhkQb2JWavOWfjgkdvUqibGJeNNaz1/Z1PPza5/tAPXICI6A==",
       "cpu": [
         "x64"
       ],
@@ -10968,9 +12090,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.44.1.tgz",
-      "integrity": "sha512-n0edDmSHlXFhrlmTK7XBuwKlG5MbS7yleS1cQ9nn4kIeW+dJH+ExqNgQ0RrFRew8Y+0V/x6C5IjsHrJmiHtkxQ==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.52.3.tgz",
+      "integrity": "sha512-IoerZJ4l1wRMopEHRKOO16e04iXRDyZFZnNZKrWeNquh5d6bucjezgd+OxG03mOMTnS1x7hilzb3uURPkJ0OfA==",
       "cpu": [
         "arm"
       ],
@@ -10982,9 +12104,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-arm-musleabihf": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.44.1.tgz",
-      "integrity": "sha512-8WVUPy3FtAsKSpyk21kV52HCxB+me6YkbkFHATzC2Yd3yuqHwy2lbFL4alJOLXKljoRw08Zk8/xEj89cLQ/4Nw==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.52.3.tgz",
+      "integrity": "sha512-ZYdtqgHTDfvrJHSh3W22TvjWxwOgc3ThK/XjgcNGP2DIwFIPeAPNsQxrJO5XqleSlgDux2VAoWQ5iJrtaC1TbA==",
       "cpu": [
         "arm"
       ],
@@ -10996,9 +12118,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-arm64-gnu": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.44.1.tgz",
-      "integrity": "sha512-yuktAOaeOgorWDeFJggjuCkMGeITfqvPgkIXhDqsfKX8J3jGyxdDZgBV/2kj/2DyPaLiX6bPdjJDTu9RB8lUPQ==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.52.3.tgz",
+      "integrity": "sha512-NcViG7A0YtuFDA6xWSgmFb6iPFzHlf5vcqb2p0lGEbT+gjrEEz8nC/EeDHvx6mnGXnGCC1SeVV+8u+smj0CeGQ==",
       "cpu": [
         "arm64"
       ],
@@ -11010,9 +12132,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-arm64-musl": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.44.1.tgz",
-      "integrity": "sha512-W+GBM4ifET1Plw8pdVaecwUgxmiH23CfAUj32u8knq0JPFyK4weRy6H7ooxYFD19YxBulL0Ktsflg5XS7+7u9g==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.52.3.tgz",
+      "integrity": "sha512-d3pY7LWno6SYNXRm6Ebsq0DJGoiLXTb83AIPCXl9fmtIQs/rXoS8SJxxUNtFbJ5MiOvs+7y34np77+9l4nfFMw==",
       "cpu": [
         "arm64"
       ],
@@ -11023,10 +12145,10 @@
         "linux"
       ]
     },
-    "node_modules/@rollup/rollup-linux-loongarch64-gnu": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loongarch64-gnu/-/rollup-linux-loongarch64-gnu-4.44.1.tgz",
-      "integrity": "sha512-1zqnUEMWp9WrGVuVak6jWTl4fEtrVKfZY7CvcBmUUpxAJ7WcSowPSAWIKa/0o5mBL/Ij50SIf9tuirGx63Ovew==",
+    "node_modules/@rollup/rollup-linux-loong64-gnu": {
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.52.3.tgz",
+      "integrity": "sha512-3y5GA0JkBuirLqmjwAKwB0keDlI6JfGYduMlJD/Rl7fvb4Ni8iKdQs1eiunMZJhwDWdCvrcqXRY++VEBbvk6Eg==",
       "cpu": [
         "loong64"
       ],
@@ -11037,10 +12159,10 @@
         "linux"
       ]
     },
-    "node_modules/@rollup/rollup-linux-powerpc64le-gnu": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-powerpc64le-gnu/-/rollup-linux-powerpc64le-gnu-4.44.1.tgz",
-      "integrity": "sha512-Rl3JKaRu0LHIx7ExBAAnf0JcOQetQffaw34T8vLlg9b1IhzcBgaIdnvEbbsZq9uZp3uAH+JkHd20Nwn0h9zPjA==",
+    "node_modules/@rollup/rollup-linux-ppc64-gnu": {
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.52.3.tgz",
+      "integrity": "sha512-AUUH65a0p3Q0Yfm5oD2KVgzTKgwPyp9DSXc3UA7DtxhEb/WSPfbG4wqXeSN62OG5gSo18em4xv6dbfcUGXcagw==",
       "cpu": [
         "ppc64"
       ],
@@ -11052,9 +12174,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-riscv64-gnu": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.44.1.tgz",
-      "integrity": "sha512-j5akelU3snyL6K3N/iX7otLBIl347fGwmd95U5gS/7z6T4ftK288jKq3A5lcFKcx7wwzb5rgNvAg3ZbV4BqUSw==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.52.3.tgz",
+      "integrity": "sha512-1makPhFFVBqZE+XFg3Dkq+IkQ7JvmUrwwqaYBL2CE+ZpxPaqkGaiWFEWVGyvTwZace6WLJHwjVh/+CXbKDGPmg==",
       "cpu": [
         "riscv64"
       ],
@@ -11066,9 +12188,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-riscv64-musl": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.44.1.tgz",
-      "integrity": "sha512-ppn5llVGgrZw7yxbIm8TTvtj1EoPgYUAbfw0uDjIOzzoqlZlZrLJ/KuiE7uf5EpTpCTrNt1EdtzF0naMm0wGYg==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.52.3.tgz",
+      "integrity": "sha512-OOFJa28dxfl8kLOPMUOQBCO6z3X2SAfzIE276fwT52uXDWUS178KWq0pL7d6p1kz7pkzA0yQwtqL0dEPoVcRWg==",
       "cpu": [
         "riscv64"
       ],
@@ -11080,9 +12202,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-s390x-gnu": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.44.1.tgz",
-      "integrity": "sha512-Hu6hEdix0oxtUma99jSP7xbvjkUM/ycke/AQQ4EC5g7jNRLLIwjcNwaUy95ZKBJJwg1ZowsclNnjYqzN4zwkAw==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.52.3.tgz",
+      "integrity": "sha512-jMdsML2VI5l+V7cKfZx3ak+SLlJ8fKvLJ0Eoa4b9/vCUrzXKgoKxvHqvJ/mkWhFiyp88nCkM5S2v6nIwRtPcgg==",
       "cpu": [
         "s390x"
       ],
@@ -11094,9 +12216,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-x64-gnu": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.44.1.tgz",
-      "integrity": "sha512-EtnsrmZGomz9WxK1bR5079zee3+7a+AdFlghyd6VbAjgRJDbTANJ9dcPIPAi76uG05micpEL+gPGmAKYTschQw==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.52.3.tgz",
+      "integrity": "sha512-tPgGd6bY2M2LJTA1uGq8fkSPK8ZLYjDjY+ZLK9WHncCnfIz29LIXIqUgzCR0hIefzy6Hpbe8Th5WOSwTM8E7LA==",
       "cpu": [
         "x64"
       ],
@@ -11108,9 +12230,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-x64-musl": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.44.1.tgz",
-      "integrity": "sha512-iAS4p+J1az6Usn0f8xhgL4PaU878KEtutP4hqw52I4IO6AGoyOkHCxcc4bqufv1tQLdDWFx8lR9YlwxKuv3/3g==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.52.3.tgz",
+      "integrity": "sha512-BCFkJjgk+WFzP+tcSMXq77ymAPIxsX9lFJWs+2JzuZTLtksJ2o5hvgTdIcZ5+oKzUDMwI0PfWzRBYAydAHF2Mw==",
       "cpu": [
         "x64"
       ],
@@ -11121,10 +12243,24 @@
         "linux"
       ]
     },
+    "node_modules/@rollup/rollup-openharmony-arm64": {
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.52.3.tgz",
+      "integrity": "sha512-KTD/EqjZF3yvRaWUJdD1cW+IQBk4fbQaHYJUmP8N4XoKFZilVL8cobFSTDnjTtxWJQ3JYaMgF4nObY/+nYkumA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ]
+    },
     "node_modules/@rollup/rollup-win32-arm64-msvc": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.44.1.tgz",
-      "integrity": "sha512-NtSJVKcXwcqozOl+FwI41OH3OApDyLk3kqTJgx8+gp6On9ZEt5mYhIsKNPGuaZr3p9T6NWPKGU/03Vw4CNU9qg==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.52.3.tgz",
+      "integrity": "sha512-+zteHZdoUYLkyYKObGHieibUFLbttX2r+58l27XZauq0tcWYYuKUwY2wjeCN9oK1Um2YgH2ibd6cnX/wFD7DuA==",
       "cpu": [
         "arm64"
       ],
@@ -11136,9 +12272,9 @@
       ]
     },
     "node_modules/@rollup/rollup-win32-ia32-msvc": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.44.1.tgz",
-      "integrity": "sha512-JYA3qvCOLXSsnTR3oiyGws1Dm0YTuxAAeaYGVlGpUsHqloPcFjPg+X0Fj2qODGLNwQOAcCiQmHub/V007kiH5A==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.52.3.tgz",
+      "integrity": "sha512-of1iHkTQSo3kr6dTIRX6t81uj/c/b15HXVsPcEElN5sS859qHrOepM5p9G41Hah+CTqSh2r8Bm56dL2z9UQQ7g==",
       "cpu": [
         "ia32"
       ],
@@ -11149,10 +12285,24 @@
         "win32"
       ]
     },
+    "node_modules/@rollup/rollup-win32-x64-gnu": {
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.52.3.tgz",
+      "integrity": "sha512-s0hybmlHb56mWVZQj8ra9048/WZTPLILKxcvcq+8awSZmyiSUZjjem1AhU3Tf4ZKpYhK4mg36HtHDOe8QJS5PQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
     "node_modules/@rollup/rollup-win32-x64-msvc": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.44.1.tgz",
-      "integrity": "sha512-J8o22LuF0kTe7m+8PvW9wk3/bRq5+mRo5Dqo6+vXb7otCm3TPhYOJqOaQtGU9YMWQSL3krMnoOxMr0+9E6F3Ug==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.52.3.tgz",
+      "integrity": "sha512-zGIbEVVXVtauFgl3MRwGWEN36P5ZGenHRMgNw88X5wEhEBpq0XrMEZwOn07+ICrwM17XO5xfMZqh0OldCH5VTA==",
       "cpu": [
         "x64"
       ],
@@ -11164,9 +12314,9 @@
       ]
     },
     "node_modules/@rollup/wasm-node": {
-      "version": "4.52.4",
-      "resolved": "https://registry.npmjs.org/@rollup/wasm-node/-/wasm-node-4.52.4.tgz",
-      "integrity": "sha512-QME8thp2j0GvRu/H8kz3uOawi45rexNIys38kITnMYp8Wl+gyeoIIuKyw8y0Lrq6xSAXgGCoqDyHD+m0wX1jnQ==",
+      "version": "4.52.5",
+      "resolved": "https://registry.npmjs.org/@rollup/wasm-node/-/wasm-node-4.52.5.tgz",
+      "integrity": "sha512-ldY4tEzSMBHNwB8TfRpi7RRRjjyfKlwjdebw5pS1lu0xaY3g4RDc6ople2wEYulVOKVeH7ZJwRx0iw4pGtjMHg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -11348,7 +12498,6 @@
       "integrity": "sha512-sUd2LfiDhqYVfvknuoz0+/c+wSpn693xotnG5g1CSWKZArbtwiYzBIVnNlcHGmuoBRsnj/TkSq8dTQ7gwfBroQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@module-federation/runtime-tools": "0.18.0",
         "@rspack/binding": "1.5.8",
@@ -11567,9 +12716,9 @@
       }
     },
     "node_modules/@rspack/plugin-react-refresh": {
-      "version": "1.5.1",
-      "resolved": "https://registry.npmjs.org/@rspack/plugin-react-refresh/-/plugin-react-refresh-1.5.1.tgz",
-      "integrity": "sha512-GT3KV1GSmIXO8dQg6taNf9AuZ8XHEs8cZqRn5mC2GT6DPCvUA/ZKezIGsHTyH+HMEbJnJ/T8yYeJnvnzuUcqAQ==",
+      "version": "1.5.2",
+      "resolved": "https://registry.npmjs.org/@rspack/plugin-react-refresh/-/plugin-react-refresh-1.5.2.tgz",
+      "integrity": "sha512-uTbN6P01LPdQOnl5YNwHkN4hDsb9Sb5nIetQb55mPyFiJnu9MQetmBUm+tmh8JJg0QPv4Ew7tXgi4hjpHFY3Rw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -11592,7 +12741,6 @@
       "integrity": "sha512-eOEKBRcxt68xzZmqlgMJ5m9FOClzZumyltQhiBeAQfCrMAjxJZaB+pbyYreI+2DL91d/VkldJ9D/UcHZrhfLnQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@angular-devkit/core": "20.1.1",
         "@angular-devkit/schematics": "20.1.1",
@@ -11712,16 +12860,16 @@
       }
     },
     "node_modules/@storybook/addon-docs": {
-      "version": "9.1.11",
-      "resolved": "https://registry.npmjs.org/@storybook/addon-docs/-/addon-docs-9.1.11.tgz",
-      "integrity": "sha512-mui6s3CwH1Oj5/1+y+YDcttLUKdvkyghmUioB6L7Hsix2yv3J0ju6JXRo+hCYisvKaPvLS7+1xQAd0mgYKKanA==",
+      "version": "9.1.13",
+      "resolved": "https://registry.npmjs.org/@storybook/addon-docs/-/addon-docs-9.1.13.tgz",
+      "integrity": "sha512-V1nCo7bfC3kQ5VNVq0VDcHsIhQf507m+BxMA5SIYiwdJHljH2BXpW2fL3FFn9gv9Wp57AEEzhm+wh4zANaJgkg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@mdx-js/react": "^3.0.0",
-        "@storybook/csf-plugin": "9.1.11",
+        "@storybook/csf-plugin": "9.1.13",
         "@storybook/icons": "^1.4.0",
-        "@storybook/react-dom-shim": "9.1.11",
+        "@storybook/react-dom-shim": "9.1.13",
         "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
         "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
         "ts-dedent": "^2.0.0"
@@ -11731,17 +12879,17 @@
         "url": "https://opencollective.com/storybook"
       },
       "peerDependencies": {
-        "storybook": "^9.1.11"
+        "storybook": "^9.1.13"
       }
     },
     "node_modules/@storybook/angular": {
-      "version": "9.1.11",
-      "resolved": "https://registry.npmjs.org/@storybook/angular/-/angular-9.1.11.tgz",
-      "integrity": "sha512-83/6fjDNJbPed0DTiFnLiWOV10gW9vUFY1l8IdTvbWiQaG5MNcVyofDaUyPsM9MQzbc2Kga9TxT+3+xaQdjwBQ==",
+      "version": "9.1.13",
+      "resolved": "https://registry.npmjs.org/@storybook/angular/-/angular-9.1.13.tgz",
+      "integrity": "sha512-h0Yw3jRqmIMJ9zpBhshVo8UDuOZ2rszlChtcXrzT0cDic41V2YMffGQlfoo2V3RY2dD0s5j4OAGKl453bkXlYA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@storybook/builder-webpack5": "9.1.11",
+        "@storybook/builder-webpack5": "9.1.13",
         "@storybook/global": "^5.0.0",
         "telejson": "8.0.0",
         "ts-dedent": "^2.0.0",
@@ -11769,7 +12917,7 @@
         "@angular/platform-browser": ">=18.0.0 < 21.0.0",
         "@angular/platform-browser-dynamic": ">=18.0.0 < 21.0.0",
         "rxjs": "^6.5.3 || ^7.4.0",
-        "storybook": "^9.1.11",
+        "storybook": "^9.1.13",
         "typescript": "^4.9.0 || ^5.0.0",
         "zone.js": ">=0.14.0"
       },
@@ -11819,13 +12967,13 @@
       }
     },
     "node_modules/@storybook/builder-webpack5": {
-      "version": "9.1.11",
-      "resolved": "https://registry.npmjs.org/@storybook/builder-webpack5/-/builder-webpack5-9.1.11.tgz",
-      "integrity": "sha512-xnaN8XBh/FiozCZ8jo4iHOsT/KzCHzI3QSOw1mW/Pd/tMh5P8+GCcAj21gaeYvAikqTq5V+BHIGEGQA+7I/+Ng==",
+      "version": "9.1.13",
+      "resolved": "https://registry.npmjs.org/@storybook/builder-webpack5/-/builder-webpack5-9.1.13.tgz",
+      "integrity": "sha512-BoFXrTlc22ryLl6U5QwgV/gHVbHBcXeVSjYOyu6XZ9SPV5GGbw5T/G7NJYJAZcsz1ZxuMEYYSMFryfZ5qcjRsA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@storybook/core-webpack": "9.1.11",
+        "@storybook/core-webpack": "9.1.13",
         "case-sensitive-paths-webpack-plugin": "^2.4.0",
         "cjs-module-lexer": "^1.2.3",
         "css-loader": "^6.7.1",
@@ -11846,7 +12994,7 @@
         "url": "https://opencollective.com/storybook"
       },
       "peerDependencies": {
-        "storybook": "^9.1.11"
+        "storybook": "^9.1.13"
       },
       "peerDependenciesMeta": {
         "typescript": {
@@ -11860,7 +13008,6 @@
       "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "fast-deep-equal": "^3.1.1",
         "fast-json-stable-stringify": "^2.0.0",
@@ -12146,9 +13293,9 @@
       }
     },
     "node_modules/@storybook/core-webpack": {
-      "version": "9.1.11",
-      "resolved": "https://registry.npmjs.org/@storybook/core-webpack/-/core-webpack-9.1.11.tgz",
-      "integrity": "sha512-P7phAiRot4eTxHOY3NUMvW3HqMbn8wN4uNRLgUDSLWVIzTv3yLkvP/ovmNtHRjfrZtGbGskirYHv33V33b0d4g==",
+      "version": "9.1.13",
+      "resolved": "https://registry.npmjs.org/@storybook/core-webpack/-/core-webpack-9.1.13.tgz",
+      "integrity": "sha512-HtBZ+ZVgeqlhyMiT/Tdb/vpKrCSiZEi6p4s7y/qk04SaX8XIPSufEeqLI/ELSz2hOcuCy6smU/tE1JkqVz/4uA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -12159,13 +13306,13 @@
         "url": "https://opencollective.com/storybook"
       },
       "peerDependencies": {
-        "storybook": "^9.1.11"
+        "storybook": "^9.1.13"
       }
     },
     "node_modules/@storybook/csf-plugin": {
-      "version": "9.1.11",
-      "resolved": "https://registry.npmjs.org/@storybook/csf-plugin/-/csf-plugin-9.1.11.tgz",
-      "integrity": "sha512-3K8ZhGHyzrbhhhfWDmjatMZRxHdskw74fKPrI8JS4PXxJulXJJQDR7SQmpSjWAe+vc1oCAqfr4tLSZwi6Lmstg==",
+      "version": "9.1.13",
+      "resolved": "https://registry.npmjs.org/@storybook/csf-plugin/-/csf-plugin-9.1.13.tgz",
+      "integrity": "sha512-EMpzYuyt9FDcxxfBChWzfId50y8QMpdenviEQ8m+pa6c+ANx3pC5J6t7y0khD8TQu815sTy+nc6cc8PC45dPUA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -12176,7 +13323,7 @@
         "url": "https://opencollective.com/storybook"
       },
       "peerDependencies": {
-        "storybook": "^9.1.11"
+        "storybook": "^9.1.13"
       }
     },
     "node_modules/@storybook/global": {
@@ -12201,9 +13348,9 @@
       }
     },
     "node_modules/@storybook/react-dom-shim": {
-      "version": "9.1.11",
-      "resolved": "https://registry.npmjs.org/@storybook/react-dom-shim/-/react-dom-shim-9.1.11.tgz",
-      "integrity": "sha512-f9coD3PK/Avhtmo77B1WFU6ARRYLeuS1QoSo132BUCESyB0ak9BdimOSpIzNAXEZQrHYkNw6Ln3+0FD3vqnPrA==",
+      "version": "9.1.13",
+      "resolved": "https://registry.npmjs.org/@storybook/react-dom-shim/-/react-dom-shim-9.1.13.tgz",
+      "integrity": "sha512-/tMr9TmV3+98GEQO0S03k4gtKHGCpv9+k9Dmnv+TJK3TBz7QsaFEzMwe3gCgoTaebLACyVveDiZkWnCYAWB6NA==",
       "dev": true,
       "license": "MIT",
       "funding": {
@@ -12213,7 +13360,7 @@
       "peerDependencies": {
         "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0-beta",
         "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0-beta",
-        "storybook": "^9.1.11"
+        "storybook": "^9.1.13"
       }
     },
     "node_modules/@swc-node/register": {
@@ -12276,7 +13423,6 @@
       "dev": true,
       "hasInstallScript": true,
       "license": "Apache-2.0",
-      "peer": true,
       "dependencies": {
         "@swc/counter": "^0.1.3",
         "@swc/types": "^0.1.23"
@@ -12502,7 +13648,6 @@
       "integrity": "sha512-iAoY/qRhNH8a/hBvm3zKj9qQ4oc2+3w1unPJa2XvTK3XjeLXtzcCingVPw/9e5mn1+0yPqxcBGp9Jf0pkfMb1g==",
       "dev": true,
       "license": "Apache-2.0",
-      "peer": true,
       "dependencies": {
         "@swc/counter": "^0.1.3"
       }
@@ -12783,13 +13928,14 @@
       }
     },
     "node_modules/@types/chai": {
-      "version": "5.2.2",
-      "resolved": "https://registry.npmjs.org/@types/chai/-/chai-5.2.2.tgz",
-      "integrity": "sha512-8kB30R7Hwqf40JPiKhVzodJs2Qc1ZJ5zuT3uzw5Hq/dhNCl3G3l83jfpdI1e20BP348+fV7VIL/+FxaXkqBmWg==",
+      "version": "5.2.3",
+      "resolved": "https://registry.npmjs.org/@types/chai/-/chai-5.2.3.tgz",
+      "integrity": "sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@types/deep-eql": "*"
+        "@types/deep-eql": "*",
+        "assertion-error": "^2.0.1"
       }
     },
     "node_modules/@types/connect": {
@@ -12861,7 +14007,6 @@
       "integrity": "sha512-Crp6WY9aTYP3qPi2wGDo9iUe/rceX01UMhnF1jmwDcKCFM6cx7YhGP/Mpr3y9AASpfHixIG0E6azCcL5OcDHsQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@types/body-parser": "*",
         "@types/express-serve-static-core": "^4.17.33",
@@ -13072,8 +14217,7 @@
       "resolved": "https://registry.npmjs.org/@types/node/-/node-18.16.9.tgz",
       "integrity": "sha512-IeB32oIV4oGArLrd7znD2rkHQ6EDCM+2Sr76dJnrHwv9OHBTTM6nuDLK9bmikXzPa0ZlWMWtRGo/Uw4mrzQedA==",
       "dev": true,
-      "license": "MIT",
-      "peer": true
+      "license": "MIT"
     },
     "node_modules/@types/node-forge": {
       "version": "1.3.14",
@@ -13252,17 +14396,17 @@
       "license": "MIT"
     },
     "node_modules/@typescript-eslint/eslint-plugin": {
-      "version": "8.46.1",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.46.1.tgz",
-      "integrity": "sha512-rUsLh8PXmBjdiPY+Emjz9NX2yHvhS11v0SR6xNJkm5GM1MO9ea/1GoDKlHHZGrOJclL/cZ2i/vRUYVtjRhrHVQ==",
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.46.2.tgz",
+      "integrity": "sha512-ZGBMToy857/NIPaaCucIUQgqueOiq7HeAKkhlvqVV4lm089zUFW6ikRySx2v+cAhKeUCPuWVHeimyk6Dw1iY3w==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@eslint-community/regexpp": "^4.10.0",
-        "@typescript-eslint/scope-manager": "8.46.1",
-        "@typescript-eslint/type-utils": "8.46.1",
-        "@typescript-eslint/utils": "8.46.1",
-        "@typescript-eslint/visitor-keys": "8.46.1",
+        "@typescript-eslint/scope-manager": "8.46.2",
+        "@typescript-eslint/type-utils": "8.46.2",
+        "@typescript-eslint/utils": "8.46.2",
+        "@typescript-eslint/visitor-keys": "8.46.2",
         "graphemer": "^1.4.0",
         "ignore": "^7.0.0",
         "natural-compare": "^1.4.0",
@@ -13276,7 +14420,7 @@
         "url": "https://opencollective.com/typescript-eslint"
       },
       "peerDependencies": {
-        "@typescript-eslint/parser": "^8.46.1",
+        "@typescript-eslint/parser": "^8.46.2",
         "eslint": "^8.57.0 || ^9.0.0",
         "typescript": ">=4.8.4 <6.0.0"
       }
@@ -13292,17 +14436,16 @@
       }
     },
     "node_modules/@typescript-eslint/parser": {
-      "version": "8.46.1",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.46.1.tgz",
-      "integrity": "sha512-6JSSaBZmsKvEkbRUkf7Zj7dru/8ZCrJxAqArcLaVMee5907JdtEbKGsZ7zNiIm/UAkpGUkaSMZEXShnN2D1HZA==",
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.46.2.tgz",
+      "integrity": "sha512-BnOroVl1SgrPLywqxyqdJ4l3S2MsKVLDVxZvjI1Eoe8ev2r3kGDo+PcMihNmDE+6/KjkTubSJnmqGZZjQSBq/g==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
-        "@typescript-eslint/scope-manager": "8.46.1",
-        "@typescript-eslint/types": "8.46.1",
-        "@typescript-eslint/typescript-estree": "8.46.1",
-        "@typescript-eslint/visitor-keys": "8.46.1",
+        "@typescript-eslint/scope-manager": "8.46.2",
+        "@typescript-eslint/types": "8.46.2",
+        "@typescript-eslint/typescript-estree": "8.46.2",
+        "@typescript-eslint/visitor-keys": "8.46.2",
         "debug": "^4.3.4"
       },
       "engines": {
@@ -13318,14 +14461,14 @@
       }
     },
     "node_modules/@typescript-eslint/project-service": {
-      "version": "8.46.1",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.46.1.tgz",
-      "integrity": "sha512-FOIaFVMHzRskXr5J4Jp8lFVV0gz5ngv3RHmn+E4HYxSJ3DgDzU7fVI1/M7Ijh1zf6S7HIoaIOtln1H5y8V+9Zg==",
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.46.2.tgz",
+      "integrity": "sha512-PULOLZ9iqwI7hXcmL4fVfIsBi6AN9YxRc0frbvmg8f+4hQAjQ5GYNKK0DIArNo+rOKmR/iBYwkpBmnIwin4wBg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/tsconfig-utils": "^8.46.1",
-        "@typescript-eslint/types": "^8.46.1",
+        "@typescript-eslint/tsconfig-utils": "^8.46.2",
+        "@typescript-eslint/types": "^8.46.2",
         "debug": "^4.3.4"
       },
       "engines": {
@@ -13340,14 +14483,14 @@
       }
     },
     "node_modules/@typescript-eslint/scope-manager": {
-      "version": "8.46.1",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.46.1.tgz",
-      "integrity": "sha512-weL9Gg3/5F0pVQKiF8eOXFZp8emqWzZsOJuWRUNtHT+UNV2xSJegmpCNQHy37aEQIbToTq7RHKhWvOsmbM680A==",
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.46.2.tgz",
+      "integrity": "sha512-LF4b/NmGvdWEHD2H4MsHD8ny6JpiVNDzrSZr3CsckEgCbAGZbYM4Cqxvi9L+WqDMT+51Ozy7lt2M+d0JLEuBqA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/types": "8.46.1",
-        "@typescript-eslint/visitor-keys": "8.46.1"
+        "@typescript-eslint/types": "8.46.2",
+        "@typescript-eslint/visitor-keys": "8.46.2"
       },
       "engines": {
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -13358,9 +14501,9 @@
       }
     },
     "node_modules/@typescript-eslint/tsconfig-utils": {
-      "version": "8.46.1",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.46.1.tgz",
-      "integrity": "sha512-X88+J/CwFvlJB+mK09VFqx5FE4H5cXD+H/Bdza2aEWkSb8hnWIQorNcscRl4IEo1Cz9VI/+/r/jnGWkbWPx54g==",
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.46.2.tgz",
+      "integrity": "sha512-a7QH6fw4S57+F5y2FIxxSDyi5M4UfGF+Jl1bCGd7+L4KsaUY80GsiF/t0UoRFDHAguKlBaACWJRmdrc6Xfkkag==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -13375,15 +14518,15 @@
       }
     },
     "node_modules/@typescript-eslint/type-utils": {
-      "version": "8.46.1",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.46.1.tgz",
-      "integrity": "sha512-+BlmiHIiqufBxkVnOtFwjah/vrkF4MtKKvpXrKSPLCkCtAp8H01/VV43sfqA98Od7nJpDcFnkwgyfQbOG0AMvw==",
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.46.2.tgz",
+      "integrity": "sha512-HbPM4LbaAAt/DjxXaG9yiS9brOOz6fabal4uvUmaUYe6l3K1phQDMQKBRUrr06BQkxkvIZVVHttqiybM9nJsLA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/types": "8.46.1",
-        "@typescript-eslint/typescript-estree": "8.46.1",
-        "@typescript-eslint/utils": "8.46.1",
+        "@typescript-eslint/types": "8.46.2",
+        "@typescript-eslint/typescript-estree": "8.46.2",
+        "@typescript-eslint/utils": "8.46.2",
         "debug": "^4.3.4",
         "ts-api-utils": "^2.1.0"
       },
@@ -13400,12 +14543,11 @@
       }
     },
     "node_modules/@typescript-eslint/types": {
-      "version": "8.46.1",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.46.1.tgz",
-      "integrity": "sha512-C+soprGBHwWBdkDpbaRC4paGBrkIXxVlNohadL5o0kfhsXqOC6GYH2S/Obmig+I0HTDl8wMaRySwrfrXVP8/pQ==",
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.46.2.tgz",
+      "integrity": "sha512-lNCWCbq7rpg7qDsQrd3D6NyWYu+gkTENkG5IKYhUIcxSb59SQC/hEQ+MrG4sTgBVghTonNWq42bA/d4yYumldQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "engines": {
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
       },
@@ -13415,16 +14557,16 @@
       }
     },
     "node_modules/@typescript-eslint/typescript-estree": {
-      "version": "8.46.1",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.46.1.tgz",
-      "integrity": "sha512-uIifjT4s8cQKFQ8ZBXXyoUODtRoAd7F7+G8MKmtzj17+1UbdzFl52AzRyZRyKqPHhgzvXunnSckVu36flGy8cg==",
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.46.2.tgz",
+      "integrity": "sha512-f7rW7LJ2b7Uh2EiQ+7sza6RDZnajbNbemn54Ob6fRwQbgcIn+GWfyuHDHRYgRoZu1P4AayVScrRW+YfbTvPQoQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/project-service": "8.46.1",
-        "@typescript-eslint/tsconfig-utils": "8.46.1",
-        "@typescript-eslint/types": "8.46.1",
-        "@typescript-eslint/visitor-keys": "8.46.1",
+        "@typescript-eslint/project-service": "8.46.2",
+        "@typescript-eslint/tsconfig-utils": "8.46.2",
+        "@typescript-eslint/types": "8.46.2",
+        "@typescript-eslint/visitor-keys": "8.46.2",
         "debug": "^4.3.4",
         "fast-glob": "^3.3.2",
         "is-glob": "^4.0.3",
@@ -13460,17 +14602,16 @@
       }
     },
     "node_modules/@typescript-eslint/utils": {
-      "version": "8.46.1",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.46.1.tgz",
-      "integrity": "sha512-vkYUy6LdZS7q1v/Gxb2Zs7zziuXN0wxqsetJdeZdRe/f5dwJFglmuvZBfTUivCtjH725C1jWCDfpadadD95EDQ==",
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.46.2.tgz",
+      "integrity": "sha512-sExxzucx0Tud5tE0XqR0lT0psBQvEpnpiul9XbGUB1QwpWJJAps1O/Z7hJxLGiZLBKMCutjTzDgmd1muEhBnVg==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@eslint-community/eslint-utils": "^4.7.0",
-        "@typescript-eslint/scope-manager": "8.46.1",
-        "@typescript-eslint/types": "8.46.1",
-        "@typescript-eslint/typescript-estree": "8.46.1"
+        "@typescript-eslint/scope-manager": "8.46.2",
+        "@typescript-eslint/types": "8.46.2",
+        "@typescript-eslint/typescript-estree": "8.46.2"
       },
       "engines": {
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -13485,13 +14626,13 @@
       }
     },
     "node_modules/@typescript-eslint/visitor-keys": {
-      "version": "8.46.1",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.46.1.tgz",
-      "integrity": "sha512-ptkmIf2iDkNUjdeu2bQqhFPV1m6qTnFFjg7PPDjxKWaMaP0Z6I9l30Jr3g5QqbZGdw8YdYvLp+XnqnWWZOg/NA==",
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.46.2.tgz",
+      "integrity": "sha512-tUFMXI4gxzzMXt4xpGJEsBsTox0XbNQ1y94EwlD/CuZwFcQP79xfQqMhau9HsRc/J0cAPA/HZt1dZPtGn9V/7w==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/types": "8.46.1",
+        "@typescript-eslint/types": "8.46.2",
         "eslint-visitor-keys": "^4.2.1"
       },
       "engines": {
@@ -13967,7 +15108,6 @@
       "integrity": "sha512-hGISOaP18plkzbWEcP/QvtRW1xDXF2+96HbEX6byqQhAUbiS5oH6/9JwW+QsQCIYON2bI6QZBF+2PvOmrRZ9wA==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@vitest/utils": "3.2.4",
         "fflate": "^0.8.2",
@@ -14201,7 +15341,6 @@
       "integrity": "sha512-nrUSn7hzt7J6JWgWGz78ZYI8wj+gdIJdk0Ynjpp8l+trkn58Uqsf6RYrYkEK+3X18EX+TNdtJI0WxAtc+L84SQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "argparse": "^2.0.1"
       },
@@ -14259,7 +15398,6 @@
       "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "bin": {
         "acorn": "bin/acorn"
       },
@@ -14278,6 +15416,19 @@
         "acorn-walk": "^8.0.2"
       }
     },
+    "node_modules/acorn-import-phases": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/acorn-import-phases/-/acorn-import-phases-1.0.4.tgz",
+      "integrity": "sha512-wKmbr/DDiIXzEOiWrTTUcDm24kQ2vGfZQvM2fwg2vXqR5uW6aapr7ObPtj1th32b9u90/Pf4AItvdTh42fBmVQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.13.0"
+      },
+      "peerDependencies": {
+        "acorn": "^8.14.0"
+      }
+    },
     "node_modules/acorn-jsx": {
       "version": "5.3.2",
       "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz",
@@ -14366,7 +15517,6 @@
       "integrity": "sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "fast-deep-equal": "^3.1.3",
         "fast-uri": "^3.0.1",
@@ -14410,25 +15560,26 @@
       }
     },
     "node_modules/algoliasearch": {
-      "version": "5.32.0",
-      "resolved": "https://registry.npmjs.org/algoliasearch/-/algoliasearch-5.32.0.tgz",
-      "integrity": "sha512-84xBncKNPBK8Ae89F65+SyVcOihrIbm/3N7to+GpRBHEUXGjA3ydWTMpcRW6jmFzkBQ/eqYy/y+J+NBpJWYjBg==",
+      "version": "5.35.0",
+      "resolved": "https://registry.npmjs.org/algoliasearch/-/algoliasearch-5.35.0.tgz",
+      "integrity": "sha512-Y+moNhsqgLmvJdgTsO4GZNgsaDWv8AOGAaPeIeHKlDn/XunoAqYbA+XNpBd1dW8GOXAUDyxC9Rxc7AV4kpFcIg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-abtesting": "5.32.0",
-        "@algolia/client-analytics": "5.32.0",
-        "@algolia/client-common": "5.32.0",
-        "@algolia/client-insights": "5.32.0",
-        "@algolia/client-personalization": "5.32.0",
-        "@algolia/client-query-suggestions": "5.32.0",
-        "@algolia/client-search": "5.32.0",
-        "@algolia/ingestion": "1.32.0",
-        "@algolia/monitoring": "1.32.0",
-        "@algolia/recommend": "5.32.0",
-        "@algolia/requester-browser-xhr": "5.32.0",
-        "@algolia/requester-fetch": "5.32.0",
-        "@algolia/requester-node-http": "5.32.0"
+        "@algolia/abtesting": "1.1.0",
+        "@algolia/client-abtesting": "5.35.0",
+        "@algolia/client-analytics": "5.35.0",
+        "@algolia/client-common": "5.35.0",
+        "@algolia/client-insights": "5.35.0",
+        "@algolia/client-personalization": "5.35.0",
+        "@algolia/client-query-suggestions": "5.35.0",
+        "@algolia/client-search": "5.35.0",
+        "@algolia/ingestion": "1.35.0",
+        "@algolia/monitoring": "1.35.0",
+        "@algolia/recommend": "5.35.0",
+        "@algolia/requester-browser-xhr": "5.35.0",
+        "@algolia/requester-fetch": "5.35.0",
+        "@algolia/requester-node-http": "5.35.0"
       },
       "engines": {
         "node": ">= 14.0.0"
@@ -14585,7 +15736,8 @@
       "integrity": "sha512-tLIEcj5GuR2RSTnxNKdkK0dJ/GrC7P38sUkiDmDuHfsHmbagTFAxDVIBltoklXEVIQ/f14IL8IMJ5pn9Hez1Ew==",
       "dev": true,
       "license": "ISC",
-      "optional": true
+      "optional": true,
+      "peer": true
     },
     "node_modules/are-we-there-yet": {
       "version": "2.0.0",
@@ -14595,6 +15747,7 @@
       "dev": true,
       "license": "ISC",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "delegates": "^1.0.0",
         "readable-stream": "^3.6.0"
@@ -14688,9 +15841,9 @@
       }
     },
     "node_modules/ast-v8-to-istanbul": {
-      "version": "0.3.6",
-      "resolved": "https://registry.npmjs.org/ast-v8-to-istanbul/-/ast-v8-to-istanbul-0.3.6.tgz",
-      "integrity": "sha512-9tx1z/7OF/a8EdYL3FKoBhxLf3h3D8fXvuSj0HknsVeli2HE40qbNZxyFhMtnydaRiamwFu9zhb+BsJ5tVPehQ==",
+      "version": "0.3.7",
+      "resolved": "https://registry.npmjs.org/ast-v8-to-istanbul/-/ast-v8-to-istanbul-0.3.7.tgz",
+      "integrity": "sha512-kr1Hy6YRZBkGQSb6puP+D6FQ59Cx4m0siYhAxygMCAgadiWQ6oxAxQXHOMvJx67SJ63jRoVIIg5eXzUbbct1ww==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -15013,14 +16166,14 @@
       }
     },
     "node_modules/babel-plugin-polyfill-corejs3": {
-      "version": "0.11.1",
-      "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs3/-/babel-plugin-polyfill-corejs3-0.11.1.tgz",
-      "integrity": "sha512-yGCqvBT4rwMczo28xkH/noxJ6MZ4nJfkVYdoDaC/utLtWrXxv27HVrzAeSbqR8SxDsp46n0YF47EbHoixy6rXQ==",
+      "version": "0.13.0",
+      "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs3/-/babel-plugin-polyfill-corejs3-0.13.0.tgz",
+      "integrity": "sha512-U+GNwMdSFgzVmfhNm8GJUX88AadB3uo9KpJqS3FaqNIPKgySuvMb+bHPsOmmuWyIcuqZj/pzt1RUIUZns4y2+A==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@babel/helper-define-polyfill-provider": "^0.6.3",
-        "core-js-compat": "^3.40.0"
+        "@babel/helper-define-polyfill-provider": "^0.6.5",
+        "core-js-compat": "^3.43.0"
       },
       "peerDependencies": {
         "@babel/core": "^7.4.0 || ^8.0.0-0 <8.0.0"
@@ -15122,9 +16275,9 @@
       "license": "MIT"
     },
     "node_modules/baseline-browser-mapping": {
-      "version": "2.8.16",
-      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.8.16.tgz",
-      "integrity": "sha512-OMu3BGQ4E7P1ErFsIPpbJh0qvDudM/UuJeHgkAvfWe+0HFJCXh+t/l8L6fVLR55RI/UbKrVLnAXZSVwd9ysWYw==",
+      "version": "2.8.18",
+      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.8.18.tgz",
+      "integrity": "sha512-UYmTpOBwgPScZpS4A+YbapwWuBwasxvO/2IOHArSsAhL/+ZdmATBXTex3t+l2hXwLVYK382ibr/nKoY9GKe86w==",
       "license": "Apache-2.0",
       "bin": {
         "baseline-browser-mapping": "dist/cli.js"
@@ -15158,14 +16311,14 @@
       "license": "MIT"
     },
     "node_modules/beasties": {
-      "version": "0.3.4",
-      "resolved": "https://registry.npmjs.org/beasties/-/beasties-0.3.4.tgz",
-      "integrity": "sha512-NmzN1zN1cvGccXFyZ73335+ASXwBlVWcUPssiUDIlFdfyatHPRRufjCd5w8oPaQPvVnf9ELklaCGb1gi9FBwIw==",
+      "version": "0.3.5",
+      "resolved": "https://registry.npmjs.org/beasties/-/beasties-0.3.5.tgz",
+      "integrity": "sha512-NaWu+f4YrJxEttJSm16AzMIFtVldCvaJ68b1L098KpqXmxt9xOLtKoLkKxb8ekhOrLqEJAbvT6n6SEvB/sac7A==",
       "dev": true,
       "license": "Apache-2.0",
       "dependencies": {
-        "css-select": "^5.1.0",
-        "css-what": "^6.1.0",
+        "css-select": "^6.0.0",
+        "css-what": "^7.0.0",
         "dom-serializer": "^2.0.0",
         "domhandler": "^5.0.3",
         "htmlparser2": "^10.0.0",
@@ -15177,6 +16330,36 @@
         "node": ">=14.0.0"
       }
     },
+    "node_modules/beasties/node_modules/css-select": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/css-select/-/css-select-6.0.0.tgz",
+      "integrity": "sha512-rZZVSLle8v0+EY8QAkDWrKhpgt6SA5OtHsgBnsj6ZaLb5dmDVOWUDtQitd9ydxxvEjhewNudS6eTVU7uOyzvXw==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "boolbase": "^1.0.0",
+        "css-what": "^7.0.0",
+        "domhandler": "^5.0.3",
+        "domutils": "^3.2.2",
+        "nth-check": "^2.1.1"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/fb55"
+      }
+    },
+    "node_modules/beasties/node_modules/css-what": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/css-what/-/css-what-7.0.0.tgz",
+      "integrity": "sha512-wD5oz5xibMOPHzy13CyGmogB3phdvcDaB5t0W/Nr5Z2O/agcB8YwOz6e2Lsp10pNDzBoDO9nVa3RGs/2BttpHQ==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">= 6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/fb55"
+      }
+    },
     "node_modules/better-opn": {
       "version": "3.0.2",
       "resolved": "https://registry.npmjs.org/better-opn/-/better-opn-3.0.2.tgz",
@@ -15384,7 +16567,6 @@
         }
       ],
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "baseline-browser-mapping": "^2.8.9",
         "caniuse-lite": "^1.0.30001746",
@@ -15746,6 +16928,24 @@
       ],
       "license": "CC-BY-4.0"
     },
+    "node_modules/canvas": {
+      "version": "2.11.2",
+      "resolved": "https://registry.npmjs.org/canvas/-/canvas-2.11.2.tgz",
+      "integrity": "sha512-ItanGBMrmRV7Py2Z+Xhs7cT+FNt5K0vPL4p9EZ/UX/Mu7hFbkxSjKF2KVtPwX7UYWp7dRKnrTvReflgrItJbdw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "peer": true,
+      "dependencies": {
+        "@mapbox/node-pre-gyp": "^1.0.0",
+        "nan": "^2.17.0",
+        "simple-get": "^3.0.3"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
     "node_modules/case-sensitive-paths-webpack-plugin": {
       "version": "2.4.0",
       "resolved": "https://registry.npmjs.org/case-sensitive-paths-webpack-plugin/-/case-sensitive-paths-webpack-plugin-2.4.0.tgz",
@@ -15819,7 +17019,6 @@
       "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-4.0.3.tgz",
       "integrity": "sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "readdirp": "^4.0.1"
       },
@@ -16161,6 +17360,7 @@
       "dev": true,
       "license": "ISC",
       "optional": true,
+      "peer": true,
       "bin": {
         "color-support": "bin.js"
       }
@@ -16337,7 +17537,8 @@
       "integrity": "sha512-ty/fTekppD2fIwRvnZAVdeOiGd1c7YXEixbgJTNzqcxJWKQnjJ/V1bNEEE6hygpM3WjwHFUVK6HTjWSzV4a8sQ==",
       "dev": true,
       "license": "ISC",
-      "optional": true
+      "optional": true,
+      "peer": true
     },
     "node_modules/content-disposition": {
       "version": "1.0.0",
@@ -16416,9 +17617,9 @@
       }
     },
     "node_modules/copy-webpack-plugin": {
-      "version": "13.0.0",
-      "resolved": "https://registry.npmjs.org/copy-webpack-plugin/-/copy-webpack-plugin-13.0.0.tgz",
-      "integrity": "sha512-FgR/h5a6hzJqATDGd9YG41SeDViH+0bkHn6WNXCi5zKAZkeESeSxLySSsFLHqLEVCh0E+rITmCf0dusXWYukeQ==",
+      "version": "13.0.1",
+      "resolved": "https://registry.npmjs.org/copy-webpack-plugin/-/copy-webpack-plugin-13.0.1.tgz",
+      "integrity": "sha512-J+YV3WfhY6W/Xf9h+J1znYuqTye2xkBUIGyTPWuBAT27qajBa5mR4f8WBmfDY3YjRftT2kqZZiLi1qf0H+UOFw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -17826,6 +19027,7 @@
       "dev": true,
       "license": "MIT",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "mimic-response": "^2.0.0"
       },
@@ -18612,7 +19814,6 @@
       "dev": true,
       "hasInstallScript": true,
       "license": "MIT",
-      "peer": true,
       "bin": {
         "esbuild": "bin/esbuild"
       },
@@ -18653,7 +19854,6 @@
       "integrity": "sha512-H2/S7Pm8a9CL1uhp9OvjwrBh5Pvx0H8qVOxNu8Wed9Y7qv56MPtq+GGM8RJpq6glYJn9Wspr8uw7l55uyinNeg==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "debug": "^4.3.4"
       },
@@ -18662,9 +19862,9 @@
       }
     },
     "node_modules/esbuild-wasm": {
-      "version": "0.25.5",
-      "resolved": "https://registry.npmjs.org/esbuild-wasm/-/esbuild-wasm-0.25.5.tgz",
-      "integrity": "sha512-V/rbdOws2gDcnCAECfPrajhuafI0WY4WumUgc8ZHwOLnvmM0doLQ+dqvVFI2qkVxQsvo6880aC9IjpyDqcwwTw==",
+      "version": "0.25.9",
+      "resolved": "https://registry.npmjs.org/esbuild-wasm/-/esbuild-wasm-0.25.9.tgz",
+      "integrity": "sha512-Jpv5tCSwQg18aCqCRD3oHIX/prBhXMDapIoG//A+6+dV0e7KQMGFg85ihJ5T1EeMjbZjON3TqFy0VrGAnIHLDA==",
       "dev": true,
       "license": "MIT",
       "bin": {
@@ -18737,26 +19937,24 @@
       }
     },
     "node_modules/eslint": {
-      "version": "9.37.0",
-      "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.37.0.tgz",
-      "integrity": "sha512-XyLmROnACWqSxiGYArdef1fItQd47weqB7iwtfr9JHwRrqIXZdcFMvvEcL9xHCmL0SNsOvF0c42lWyM1U5dgig==",
+      "version": "9.38.0",
+      "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.38.0.tgz",
+      "integrity": "sha512-t5aPOpmtJcZcz5UJyY2GbvpDlsK5E8JqRqoKtfiKE3cNh437KIqfJr3A3AKf5k64NPx6d0G3dno6XDY05PqPtw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@eslint-community/eslint-utils": "^4.8.0",
         "@eslint-community/regexpp": "^4.12.1",
-        "@eslint/config-array": "^0.21.0",
-        "@eslint/config-helpers": "^0.4.0",
+        "@eslint/config-array": "^0.21.1",
+        "@eslint/config-helpers": "^0.4.1",
         "@eslint/core": "^0.16.0",
         "@eslint/eslintrc": "^3.3.1",
-        "@eslint/js": "9.37.0",
+        "@eslint/js": "9.38.0",
         "@eslint/plugin-kit": "^0.4.0",
         "@humanfs/node": "^0.16.6",
         "@humanwhocodes/module-importer": "^1.0.1",
         "@humanwhocodes/retry": "^0.4.2",
         "@types/estree": "^1.0.6",
-        "@types/json-schema": "^7.0.15",
         "ajv": "^6.12.4",
         "chalk": "^4.0.0",
         "cross-spawn": "^7.0.6",
@@ -18804,7 +20002,6 @@
       "integrity": "sha512-82GZUjRS0p/jganf6q1rEO25VSoHH0hKPCTrgillPjdI/3bgBhAE1QzHrHTizjpRvy6pGAvKjDJtk2pF9NDq8w==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "bin": {
         "eslint-config-prettier": "bin/cli.js"
       },
@@ -19193,7 +20390,6 @@
       "integrity": "sha512-DT9ck5YIRU+8GYzzU5kT3eHGA5iL+1Zd0EutOmTE9Dtk+Tvuzd23VBU+ec7HPNSTxXYO55gPV/hq4pSBJDjFpA==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "accepts": "^2.0.0",
         "body-parser": "^2.2.0",
@@ -19811,7 +21007,6 @@
       "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "fast-deep-equal": "^3.1.1",
         "fast-json-stable-stringify": "^2.0.0",
@@ -20163,6 +21358,7 @@
       "dev": true,
       "license": "ISC",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "aproba": "^1.0.3 || ^2.0.0",
         "color-support": "^1.1.2",
@@ -20184,7 +21380,8 @@
       "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
       "dev": true,
       "license": "MIT",
-      "optional": true
+      "optional": true,
+      "peer": true
     },
     "node_modules/gauge/node_modules/is-fullwidth-code-point": {
       "version": "3.0.0",
@@ -20193,6 +21390,7 @@
       "dev": true,
       "license": "MIT",
       "optional": true,
+      "peer": true,
       "engines": {
         "node": ">=8"
       }
@@ -20203,7 +21401,8 @@
       "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==",
       "dev": true,
       "license": "ISC",
-      "optional": true
+      "optional": true,
+      "peer": true
     },
     "node_modules/gauge/node_modules/string-width": {
       "version": "4.2.3",
@@ -20212,6 +21411,7 @@
       "dev": true,
       "license": "MIT",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "emoji-regex": "^8.0.0",
         "is-fullwidth-code-point": "^3.0.0",
@@ -20709,7 +21909,8 @@
       "integrity": "sha512-8Rf9Y83NBReMnx0gFzA8JImQACstCYWUplepDa9xprwwtmgEZUF0h/i5xSA625zB/I37EtrswSST6OXxwaaIJQ==",
       "dev": true,
       "license": "ISC",
-      "optional": true
+      "optional": true,
+      "peer": true
     },
     "node_modules/hasown": {
       "version": "2.0.2",
@@ -20901,7 +22102,6 @@
       "integrity": "sha512-V/PZeWsqhfpE27nKeX9EO2sbR+D17A+tLf6qU+ht66jdUsN0QLKJN27Z+1+gHrVMKgndBahes0PU6rRihDgHTw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@types/html-minifier-terser": "^6.0.0",
         "html-minifier-terser": "^6.0.2",
@@ -21445,9 +22645,9 @@
       }
     },
     "node_modules/injection-js": {
-      "version": "2.5.0",
-      "resolved": "https://registry.npmjs.org/injection-js/-/injection-js-2.5.0.tgz",
-      "integrity": "sha512-UpY2ONt4xbht4GhSqQ2zMJ1rBIQq4uOY+DlR6aOeYyqK7xadXt7UQbJIyxmgk288bPMkIZKjViieHm0O0i72Jw==",
+      "version": "2.6.0",
+      "resolved": "https://registry.npmjs.org/injection-js/-/injection-js-2.6.0.tgz",
+      "integrity": "sha512-uRUO2qh7rFFeAo3UWTbLHCFr8x3VLHRNZ2jbMv/MAxbFIFgw7QtNVfxc3iC7CV5U11cvIyAt12nxVWu1NqVsYg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -22144,7 +23344,6 @@
       "integrity": "sha512-NIy3oAFp9shda19hy4HK0HRTWKtPJmGdnvywu01nOqNC2vZg+Z+fvJDxpMQA88eb2I9EcafcdjYgsDthnYTvGw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@jest/core": "^29.7.0",
         "@jest/types": "^29.6.3",
@@ -23804,7 +25003,6 @@
       "integrity": "sha512-k9iQbsf9OyOfdzWH8HDmrRT0gSIcX+FLNW7IQq94tFX0gynPwqDTW0Ho6iMVNjGz/nb+l/vW3dWM2bbLLpkbXA==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@jest/environment": "^29.7.0",
         "@jest/fake-timers": "^29.7.0",
@@ -27011,7 +28209,6 @@
       "integrity": "sha512-rg9zJN+G4n2nfJl5MW3BMygZX56zKPNVEYYqq7adpmMh4Jn2QNEwhvQlFy6jPVdcod7txZtKHWnyZiA3a0zP7A==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "bin": {
         "jiti": "lib/jiti-cli.mjs"
       }
@@ -27072,7 +28269,6 @@
       "integrity": "sha512-/9AVW7xNbsBv6GfWho4TTNjEo9fe6Zhf9O7s0Fhhr3u+awPwAJMKwAMXnkk5vBxflqLW9hTHX/0cs+P3gW+cQw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "abab": "^2.0.6",
         "cssstyle": "^3.0.0",
@@ -27619,12 +28815,11 @@
       }
     },
     "node_modules/less": {
-      "version": "4.3.0",
-      "resolved": "https://registry.npmjs.org/less/-/less-4.3.0.tgz",
-      "integrity": "sha512-X9RyH9fvemArzfdP8Pi3irr7lor2Ok4rOttDXBhlwDg+wKQsXOXgHWduAJE1EsF7JJx0w0bcO6BC6tCKKYnXKA==",
+      "version": "4.4.0",
+      "resolved": "https://registry.npmjs.org/less/-/less-4.4.0.tgz",
+      "integrity": "sha512-kdTwsyRuncDfjEs0DlRILWNvxhDG/Zij4YLO4TMJgDLW+8OzpfkdPnRgrsRuY1o+oaxJGWsps5f/RVBgGmmN0w==",
       "dev": true,
       "license": "Apache-2.0",
-      "peer": true,
       "dependencies": {
         "copy-anything": "^2.0.1",
         "parse-node-version": "^1.0.1",
@@ -27787,9 +28982,9 @@
       }
     },
     "node_modules/listr2": {
-      "version": "8.3.3",
-      "resolved": "https://registry.npmjs.org/listr2/-/listr2-8.3.3.tgz",
-      "integrity": "sha512-LWzX2KsqcB1wqQ4AHgYb4RsDXauQiqhjLk+6hjbaeHG4zpjjVAB6wC/gz6X0l+Du1cN3pUB5ZlrvTbhGSNnUQQ==",
+      "version": "9.0.1",
+      "resolved": "https://registry.npmjs.org/listr2/-/listr2-9.0.1.tgz",
+      "integrity": "sha512-SL0JY3DaxylDuo/MecFeiC+7pedM0zia33zl0vcjgwcq1q1FWWF1To9EIauPbl8GbMCU0R2e0uJ8bZunhYKD2g==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -27801,7 +28996,7 @@
         "wrap-ansi": "^9.0.0"
       },
       "engines": {
-        "node": ">=18.0.0"
+        "node": ">=20.0.0"
       }
     },
     "node_modules/listr2/node_modules/ansi-regex": {
@@ -27897,9 +29092,9 @@
       }
     },
     "node_modules/lmdb": {
-      "version": "3.4.1",
-      "resolved": "https://registry.npmjs.org/lmdb/-/lmdb-3.4.1.tgz",
-      "integrity": "sha512-hoG9RIv42kdGJiieyElgWcKCTaw5S6Jqwyd1gLSVdsJ3+8MVm8e4yLronThiRJI9DazFAAs9xfB9nWeMQ2DWKA==",
+      "version": "3.4.2",
+      "resolved": "https://registry.npmjs.org/lmdb/-/lmdb-3.4.2.tgz",
+      "integrity": "sha512-nwVGUfTBUwJKXd6lRV8pFNfnrCC1+l49ESJRM19t/tFb/97QfJEixe5DYRvug5JO7DSFKoKaVy7oGMt5rVqZvg==",
       "dev": true,
       "hasInstallScript": true,
       "license": "MIT",
@@ -27915,13 +29110,13 @@
         "download-lmdb-prebuilds": "bin/download-prebuilds.js"
       },
       "optionalDependencies": {
-        "@lmdb/lmdb-darwin-arm64": "3.4.1",
-        "@lmdb/lmdb-darwin-x64": "3.4.1",
-        "@lmdb/lmdb-linux-arm": "3.4.1",
-        "@lmdb/lmdb-linux-arm64": "3.4.1",
-        "@lmdb/lmdb-linux-x64": "3.4.1",
-        "@lmdb/lmdb-win32-arm64": "3.4.1",
-        "@lmdb/lmdb-win32-x64": "3.4.1"
+        "@lmdb/lmdb-darwin-arm64": "3.4.2",
+        "@lmdb/lmdb-darwin-x64": "3.4.2",
+        "@lmdb/lmdb-linux-arm": "3.4.2",
+        "@lmdb/lmdb-linux-arm64": "3.4.2",
+        "@lmdb/lmdb-linux-x64": "3.4.2",
+        "@lmdb/lmdb-win32-arm64": "3.4.2",
+        "@lmdb/lmdb-win32-x64": "3.4.2"
       }
     },
     "node_modules/loader-runner": {
@@ -28536,6 +29731,7 @@
       "dev": true,
       "license": "MIT",
       "optional": true,
+      "peer": true,
       "engines": {
         "node": ">=8"
       },
@@ -28554,9 +29750,9 @@
       }
     },
     "node_modules/mini-css-extract-plugin": {
-      "version": "2.9.2",
-      "resolved": "https://registry.npmjs.org/mini-css-extract-plugin/-/mini-css-extract-plugin-2.9.2.tgz",
-      "integrity": "sha512-GJuACcS//jtq4kCtd5ii/M0SZf7OZRH+BxdqXZHaJfb8TJiVl+NgQRPwiYt2EuqeSkNydn/7vP+bcE27C5mb9w==",
+      "version": "2.9.4",
+      "resolved": "https://registry.npmjs.org/mini-css-extract-plugin/-/mini-css-extract-plugin-2.9.4.tgz",
+      "integrity": "sha512-ZWYT7ln73Hptxqxk2DxPU9MmapXRhxkJD6tkSR04dnQxm8BGu2hzgKLugK5yySD97u/8yy7Ma7E76k9ZdvtjkQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -28904,7 +30100,8 @@
       "integrity": "sha512-1UxuyYGdoQHcGg87Lkqm3FzefucTa0NAiOcuRsDmysep3c1LVCRK2krrUDafMWtjSG04htvAmvg96+SDknOmgQ==",
       "dev": true,
       "license": "MIT",
-      "optional": true
+      "optional": true,
+      "peer": true
     },
     "node_modules/nanoid": {
       "version": "3.3.11",
@@ -29026,7 +30223,6 @@
       "integrity": "sha512-objHk39HWnSSv54KD0Ct4A02rug6HiqbmXo1KJW39npzuVc37QWfiZy94afltH1zIx+mQqollmGaCmwibmagvQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@ampproject/remapping": "^2.3.0",
         "@rollup/plugin-json": "^6.1.0",
@@ -29546,6 +30742,7 @@
       "dev": true,
       "license": "ISC",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "are-we-there-yet": "^2.0.0",
         "console-control-strings": "^1.1.0",
@@ -29580,7 +30777,6 @@
       "dev": true,
       "hasInstallScript": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@napi-rs/wasm-runtime": "0.2.4",
         "@yarnpkg/lockfile": "^1.1.0",
@@ -30052,16 +31248,16 @@
       }
     },
     "node_modules/open": {
-      "version": "10.1.2",
-      "resolved": "https://registry.npmjs.org/open/-/open-10.1.2.tgz",
-      "integrity": "sha512-cxN6aIDPz6rm8hbebcP7vrQNhvRcveZoJU72Y7vskh4oIm+BZwBECnx5nTmrlres1Qapvx27Qo1Auukpf8PKXw==",
+      "version": "10.2.0",
+      "resolved": "https://registry.npmjs.org/open/-/open-10.2.0.tgz",
+      "integrity": "sha512-YgBpdJHPyQ2UE5x+hlSXcnejzAvD0b22U2OuAP+8OnlJT+PjWPxtgmGqKKc+RgTM63U9gN0YzrYc71R2WT/hTA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "default-browser": "^5.2.1",
         "define-lazy-prop": "^3.0.0",
         "is-inside-container": "^1.0.0",
-        "is-wsl": "^3.1.0"
+        "wsl-utils": "^0.1.0"
       },
       "engines": {
         "node": ">=18"
@@ -30745,16 +31941,16 @@
       }
     },
     "node_modules/piscina": {
-      "version": "5.1.2",
-      "resolved": "https://registry.npmjs.org/piscina/-/piscina-5.1.2.tgz",
-      "integrity": "sha512-9cE/BTA/xhDiyNUEj6EKWLEQC17fh/24ydYzQwcA7QdYh75K6kzL2GHvxDF5i9rFGtUaaKk7/u4xp07qiKXccQ==",
+      "version": "5.1.3",
+      "resolved": "https://registry.npmjs.org/piscina/-/piscina-5.1.3.tgz",
+      "integrity": "sha512-0u3N7H4+hbr40KjuVn2uNhOcthu/9usKhnw5vT3J7ply79v3D3M8naI00el9Klcy16x557VsEkkUQaHCWFXC/g==",
       "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=20.x"
       },
       "optionalDependencies": {
-        "@napi-rs/nice": "^1.0.1"
+        "@napi-rs/nice": "^1.0.4"
       }
     },
     "node_modules/pkce-challenge": {
@@ -30880,7 +32076,6 @@
         }
       ],
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "nanoid": "^3.3.11",
         "picocolors": "^1.1.1",
@@ -31775,7 +32970,6 @@
       "integrity": "sha512-I7AIg5boAr5R0FFtJ6rCfD+LFsWHp81dolrFD8S79U9tb8Az2nGrJncnMSnys+bpQJfRUzqs9hnA81OAA3hCuQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "bin": {
         "prettier": "bin/prettier.cjs"
       },
@@ -32128,7 +33322,6 @@
       "integrity": "sha512-tmbWg6W31tQLeB5cdIBOicJDJRR2KzXsV7uSK9iNfLWQ5bIZfxuPEHp7M8wiHyHnn0DD1i7w3Zmin0FtkrwoCQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "engines": {
         "node": ">=0.10.0"
       }
@@ -32139,7 +33332,6 @@
       "integrity": "sha512-UlbRu4cAiGaIewkPyiRGJk0imDN2T3JjieT6spoL2UeSf5od4n5LB/mQ4ejmxhCFT1tYe8IvaFulzynWovsEFQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "scheduler": "^0.27.0"
       },
@@ -32840,6 +34032,7 @@
       "dev": true,
       "license": "ISC",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "glob": "^7.1.3"
       },
@@ -32857,6 +34050,7 @@
       "dev": true,
       "license": "MIT",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "balanced-match": "^1.0.0",
         "concat-map": "0.0.1"
@@ -32870,6 +34064,7 @@
       "dev": true,
       "license": "ISC",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "fs.realpath": "^1.0.0",
         "inflight": "^1.0.4",
@@ -32892,6 +34087,7 @@
       "dev": true,
       "license": "ISC",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "brace-expansion": "^1.1.7"
       },
@@ -32918,12 +34114,11 @@
       }
     },
     "node_modules/rollup": {
-      "version": "4.44.1",
-      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.44.1.tgz",
-      "integrity": "sha512-x8H8aPvD+xbl0Do8oez5f5o8eMS3trfCghc4HhLAnCkj7Vl0d1JWGs0UF/D886zLW2rOj2QymV/JcSSsw+XDNg==",
+      "version": "4.52.3",
+      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.52.3.tgz",
+      "integrity": "sha512-RIDh866U8agLgiIcdpB+COKnlCreHJLfIhWC3LVflku5YHfpnsIKigRZeFfMfCc4dVcqNVfQQ5gO/afOck064A==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@types/estree": "1.0.8"
       },
@@ -32935,26 +34130,28 @@
         "npm": ">=8.0.0"
       },
       "optionalDependencies": {
-        "@rollup/rollup-android-arm-eabi": "4.44.1",
-        "@rollup/rollup-android-arm64": "4.44.1",
-        "@rollup/rollup-darwin-arm64": "4.44.1",
-        "@rollup/rollup-darwin-x64": "4.44.1",
-        "@rollup/rollup-freebsd-arm64": "4.44.1",
-        "@rollup/rollup-freebsd-x64": "4.44.1",
-        "@rollup/rollup-linux-arm-gnueabihf": "4.44.1",
-        "@rollup/rollup-linux-arm-musleabihf": "4.44.1",
-        "@rollup/rollup-linux-arm64-gnu": "4.44.1",
-        "@rollup/rollup-linux-arm64-musl": "4.44.1",
-        "@rollup/rollup-linux-loongarch64-gnu": "4.44.1",
-        "@rollup/rollup-linux-powerpc64le-gnu": "4.44.1",
-        "@rollup/rollup-linux-riscv64-gnu": "4.44.1",
-        "@rollup/rollup-linux-riscv64-musl": "4.44.1",
-        "@rollup/rollup-linux-s390x-gnu": "4.44.1",
-        "@rollup/rollup-linux-x64-gnu": "4.44.1",
-        "@rollup/rollup-linux-x64-musl": "4.44.1",
-        "@rollup/rollup-win32-arm64-msvc": "4.44.1",
-        "@rollup/rollup-win32-ia32-msvc": "4.44.1",
-        "@rollup/rollup-win32-x64-msvc": "4.44.1",
+        "@rollup/rollup-android-arm-eabi": "4.52.3",
+        "@rollup/rollup-android-arm64": "4.52.3",
+        "@rollup/rollup-darwin-arm64": "4.52.3",
+        "@rollup/rollup-darwin-x64": "4.52.3",
+        "@rollup/rollup-freebsd-arm64": "4.52.3",
+        "@rollup/rollup-freebsd-x64": "4.52.3",
+        "@rollup/rollup-linux-arm-gnueabihf": "4.52.3",
+        "@rollup/rollup-linux-arm-musleabihf": "4.52.3",
+        "@rollup/rollup-linux-arm64-gnu": "4.52.3",
+        "@rollup/rollup-linux-arm64-musl": "4.52.3",
+        "@rollup/rollup-linux-loong64-gnu": "4.52.3",
+        "@rollup/rollup-linux-ppc64-gnu": "4.52.3",
+        "@rollup/rollup-linux-riscv64-gnu": "4.52.3",
+        "@rollup/rollup-linux-riscv64-musl": "4.52.3",
+        "@rollup/rollup-linux-s390x-gnu": "4.52.3",
+        "@rollup/rollup-linux-x64-gnu": "4.52.3",
+        "@rollup/rollup-linux-x64-musl": "4.52.3",
+        "@rollup/rollup-openharmony-arm64": "4.52.3",
+        "@rollup/rollup-win32-arm64-msvc": "4.52.3",
+        "@rollup/rollup-win32-ia32-msvc": "4.52.3",
+        "@rollup/rollup-win32-x64-gnu": "4.52.3",
+        "@rollup/rollup-win32-x64-msvc": "4.52.3",
         "fsevents": "~2.3.2"
       }
     },
@@ -33006,9 +34203,9 @@
       "license": "MIT"
     },
     "node_modules/rslog": {
-      "version": "1.2.11",
-      "resolved": "https://registry.npmjs.org/rslog/-/rslog-1.2.11.tgz",
-      "integrity": "sha512-YgMMzQf6lL9q4rD9WS/lpPWxVNJ1ttY9+dOXJ0+7vJrKCAOT4GH0EiRnBi9mKOitcHiOwjqJPV1n/HRqqgZmOQ==",
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/rslog/-/rslog-1.3.0.tgz",
+      "integrity": "sha512-93DpwwaiRrLz7fJ5z6Uwb171hHBws1VVsWjU6IruLFX63BicLA44QNu0sfn3guKHnBHZMFSKO8akfx5QhjuegQ==",
       "dev": true,
       "license": "MIT"
     },
@@ -33054,7 +34251,6 @@
       "resolved": "https://registry.npmjs.org/rxjs/-/rxjs-7.8.2.tgz",
       "integrity": "sha512-dhKf903U/PQZY6boNNtAGdWbG85WAbjT/1xYoZIC7FAY0yWapOBQVsVrDl58W86//e1VpMNBtRV4MaXfdMySFA==",
       "license": "Apache-2.0",
-      "peer": true,
       "dependencies": {
         "tslib": "^2.1.0"
       }
@@ -33106,9 +34302,9 @@
       "license": "MIT"
     },
     "node_modules/sass": {
-      "version": "1.89.2",
-      "resolved": "https://registry.npmjs.org/sass/-/sass-1.89.2.tgz",
-      "integrity": "sha512-xCmtksBKd/jdJ9Bt9p7nPKiuqrlBMBuuGkQlkhZjjQk3Ty48lv93k5Dq6OPkKt4XwxDJ7tvlfrTa1MPA9bf+QA==",
+      "version": "1.90.0",
+      "resolved": "https://registry.npmjs.org/sass/-/sass-1.90.0.tgz",
+      "integrity": "sha512-9GUyuksjw70uNpb1MTYWsH9MQHOHY6kwfnkafC24+7aOMZn9+rVMBxRbLvw756mrBFbIsFg6Xw9IkR2Fnn3k+Q==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -33617,7 +34813,6 @@
       "resolved": "https://registry.npmjs.org/scandit-web-datacapture-core/-/scandit-web-datacapture-core-6.28.6.tgz",
       "integrity": "sha512-D7rC+SWWG0XoZVo+LNlvpJi8+sxsylhn5zvzfDGhrDI6zTAT812HNgoGJDjNNZTZ8iaS5/dYg8LU5b+N4MLsZQ==",
       "license": "SEE LICENSE IN LICENSE",
-      "peer": true,
       "dependencies": {
         "@types/howler": "^2.2.11",
         "@types/js-cookie": "^2.2.6",
@@ -33953,7 +35148,8 @@
       "integrity": "sha512-KiKBS8AnWGEyLzofFfmvKwpdPzqiy16LvQfK3yv/fVH7Bj13/wl3JSR1J+rfgRE9q7xUJK4qvgS8raSOeLUehw==",
       "dev": true,
       "license": "ISC",
-      "optional": true
+      "optional": true,
+      "peer": true
     },
     "node_modules/set-cookie-parser": {
       "version": "2.7.1",
@@ -34193,6 +35389,7 @@
       "dev": true,
       "license": "MIT",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "decompress-response": "^4.2.0",
         "once": "^1.3.1",
@@ -34566,12 +35763,11 @@
       }
     },
     "node_modules/storybook": {
-      "version": "9.1.11",
-      "resolved": "https://registry.npmjs.org/storybook/-/storybook-9.1.11.tgz",
-      "integrity": "sha512-shRR8GLKoa6qSVxgC37ojtON4n+ZCFbzxL3t69qrVmMpcKqxOyZRUI933Xoi6+RQMyzqRfgkib5dvoLIGO1V4Q==",
+      "version": "9.1.13",
+      "resolved": "https://registry.npmjs.org/storybook/-/storybook-9.1.13.tgz",
+      "integrity": "sha512-G3KZ36EVzXyHds72B/qtWiJnhUpM0xOUeYlDcO9DSHL1bDTv15cW4+upBl+mcBZrDvU838cn7Bv4GpF+O5MCfw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@storybook/global": "^5.0.0",
         "@testing-library/jest-dom": "^6.6.3",
@@ -34911,7 +36107,6 @@
       "integrity": "sha512-ZIdT8eUv8tegmqy1tTIdJv9We2DumkNZFdCF5mz/Kpq3OcTaxSuCAYZge6HKK2CmNC02G1eJig2RV7XTw5hQrA==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@adobe/css-tools": "~4.3.3",
         "debug": "^4.3.2",
@@ -35112,7 +36307,6 @@
       "integrity": "sha512-6A2rnmW5xZMdw11LYjhcI5846rt9pbLSabY5XPxo+XWdxwZaFEn47Go4NzFiHu9sNNmr/kXivP1vStfvMaK1GQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@alloc/quick-lru": "^5.2.0",
         "arg": "^5.0.2",
@@ -35189,7 +36383,6 @@
       "integrity": "sha512-/imKNG4EbWNrVjoNC/1H5/9GFy+tqjGBHCaSsN+P2RnPqjsLmv6UD3Ej+Kj8nBWaRAwyk7kK5ZUc+OEatnTR3A==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "bin": {
         "jiti": "bin/jiti.js"
       }
@@ -35433,7 +36626,6 @@
       "integrity": "sha512-+6erLbBm0+LROX2sPXlUYx/ux5PyE9K/a92Wrt6oA+WDAoFTdpHE5tCYCI5PNzq2y8df4rA+QgHLJuR4jNymsg==",
       "dev": true,
       "license": "BSD-2-Clause",
-      "peer": true,
       "dependencies": {
         "@jridgewell/source-map": "^0.3.3",
         "acorn": "^8.14.0",
@@ -36067,7 +37259,6 @@
       "integrity": "sha512-NtVysVPkxxrwFGUUxGYhfux8k78pQB3JqYBXlLRZgdGUqTO5wU/UyHop5p70iEbGhB7q5KmiZiU0Y3KlJrScEw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@cspotcode/source-map-support": "^0.8.0",
         "@tsconfig/node10": "^1.0.7",
@@ -36174,8 +37365,7 @@
       "version": "2.8.1",
       "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
       "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
-      "license": "0BSD",
-      "peer": true
+      "license": "0BSD"
     },
     "node_modules/tsscmp": {
       "version": "1.0.6",
@@ -36289,7 +37479,6 @@
       "integrity": "sha512-p1diW6TqL9L07nNxvRMM7hMMw4c5XOo/1ibL4aAIGmSAt9slTE1Xgw5KWuof2uTOvCg9BY7ZRi+GaF+7sfgPeQ==",
       "devOptional": true,
       "license": "Apache-2.0",
-      "peer": true,
       "bin": {
         "tsc": "bin/tsc",
         "tsserver": "bin/tsserver"
@@ -36299,17 +37488,16 @@
       }
     },
     "node_modules/typescript-eslint": {
-      "version": "8.46.1",
-      "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.46.1.tgz",
-      "integrity": "sha512-VHgijW803JafdSsDO8I761r3SHrgk4T00IdyQ+/UsthtgPRsBWQLqoSxOolxTpxRKi1kGXK0bSz4CoAc9ObqJA==",
+      "version": "8.46.2",
+      "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.46.2.tgz",
+      "integrity": "sha512-vbw8bOmiuYNdzzV3lsiWv6sRwjyuKJMQqWulBOU7M0RrxedXledX8G8kBbQeiOYDnTfiXz0Y4081E1QMNB6iQg==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
-        "@typescript-eslint/eslint-plugin": "8.46.1",
-        "@typescript-eslint/parser": "8.46.1",
-        "@typescript-eslint/typescript-estree": "8.46.1",
-        "@typescript-eslint/utils": "8.46.1"
+        "@typescript-eslint/eslint-plugin": "8.46.2",
+        "@typescript-eslint/parser": "8.46.2",
+        "@typescript-eslint/typescript-estree": "8.46.2",
+        "@typescript-eslint/utils": "8.46.2"
       },
       "engines": {
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -36364,12 +37552,13 @@
       }
     },
     "node_modules/undici-types": {
-      "version": "7.14.0",
-      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.14.0.tgz",
-      "integrity": "sha512-QQiYxHuyZ9gQUIrmPo3IA+hUl4KYk8uSA7cHrcKd/l3p1OTpZcM0Tbp9x7FAtXdAYhlasd60ncPpgu6ihG6TOA==",
+      "version": "7.16.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.16.0.tgz",
+      "integrity": "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==",
       "dev": true,
       "license": "MIT",
-      "optional": true
+      "optional": true,
+      "peer": true
     },
     "node_modules/unicode-canonical-property-names-ecmascript": {
       "version": "2.0.1",
@@ -36740,7 +37929,6 @@
       "integrity": "sha512-cZn6NDFE7wdTpINgs++ZJ4N49W2vRp8LCKrn3Ob1kYNtOo21vfDoaV5GzBfLU4MovSAB8uNRm4jgzVQZ+mBzPQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "esbuild": "^0.25.0",
         "fdir": "^6.4.4",
@@ -36839,7 +38027,6 @@
       "integrity": "sha512-LUCP5ev3GURDysTWiP47wRRUpLKMOfPh+yKTx3kVIEiu5KOMeqzpnYNsKyOoVrULivR8tLcks4+lga33Whn90A==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@types/chai": "^5.2.2",
         "@vitest/expect": "3.2.4",
@@ -36994,7 +38181,6 @@
       "integrity": "sha512-brOPwM3JnmOa+7kd3NsmOUOwbDAj8FT9xDsG3IW0MgbN9yZV7Oi/s/+MNQ/EcSMqw7qfoRyXPoeEWT8zLVdVGg==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@types/eslint-scope": "^3.7.7",
         "@types/estree": "^1.0.6",
@@ -37115,7 +38301,6 @@
       "integrity": "sha512-QcQ72gh8a+7JO63TAx/6XZf/CWhgMzu5m0QirvPfGvptOusAxG12w2+aua1Jkjr7hzaWDnJ2n6JFeexMHI+Zjg==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@types/bonjour": "^3.5.13",
         "@types/connect-history-api-fallback": "^1.5.4",
@@ -37637,7 +38822,6 @@
       "integrity": "sha512-khZGfAeJx6I8K9zKohEWWYN6KDlVw2DHownoe+6Vtwj1LP9WFgegXnVMSkZ/dBEBtXFwrkkydsaPFlB7f8wU2A==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "ansi-html-community": "0.0.8",
         "html-entities": "^2.1.0",
@@ -37938,6 +39122,7 @@
       "dev": true,
       "license": "ISC",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "string-width": "^1.0.2 || 2 || 3 || 4"
       }
@@ -37948,7 +39133,8 @@
       "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
       "dev": true,
       "license": "MIT",
-      "optional": true
+      "optional": true,
+      "peer": true
     },
     "node_modules/wide-align/node_modules/is-fullwidth-code-point": {
       "version": "3.0.0",
@@ -37957,6 +39143,7 @@
       "dev": true,
       "license": "MIT",
       "optional": true,
+      "peer": true,
       "engines": {
         "node": ">=8"
       }
@@ -37968,6 +39155,7 @@
       "dev": true,
       "license": "MIT",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "emoji-regex": "^8.0.0",
         "is-fullwidth-code-point": "^3.0.0",
@@ -38125,7 +39313,6 @@
       "resolved": "https://registry.npmjs.org/ws/-/ws-7.5.10.tgz",
       "integrity": "sha512-+dbF1tHwZpXcbOJdVOkzLDxZP1ailvSxM6ZweXTegylPny803bFhA+vqBYw4s31NSAk4S2Qz+AKXK9a4wkdjcQ==",
       "license": "MIT",
-      "peer": true,
       "engines": {
         "node": ">=8.3.0"
       },
@@ -38142,6 +39329,22 @@
         }
       }
     },
+    "node_modules/wsl-utils": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/wsl-utils/-/wsl-utils-0.1.0.tgz",
+      "integrity": "sha512-h3Fbisa2nKGPxCpm89Hk33lBLsnaGBvctQopaBSOW/uIs6FTe1ATyAnKFJrzVs9vpGdsTe73WF3V4lIsk4Gacw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-wsl": "^3.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/xml": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/xml/-/xml-1.0.1.tgz",
@@ -38197,7 +39400,6 @@
       "integrity": "sha512-lcYcMxX2PO9XMGvAJkJ3OsNMw+/7FKes7/hgerGUYWIoWu5j/+YQqcZr5JnPZWzOsEBgMbSbiSTn/dv/69Mkpw==",
       "dev": true,
       "license": "ISC",
-      "peer": true,
       "bin": {
         "yaml": "bin.mjs"
       },
@@ -38385,7 +39587,6 @@
       "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.76.tgz",
       "integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==",
       "license": "MIT",
-      "peer": true,
       "funding": {
         "url": "https://github.com/sponsors/colinhacks"
       }
@@ -38404,8 +39605,7 @@
       "version": "0.15.1",
       "resolved": "https://registry.npmjs.org/zone.js/-/zone.js-0.15.1.tgz",
       "integrity": "sha512-XE96n56IQpJM7NAoXswY3XRLcWFW83xe0BiAOeMD7K5k5xecOeul3Qcpx6GqEeeHNkW5DWL5zOyTbEfB4eti8w==",
-      "license": "MIT",
-      "peer": true
+      "license": "MIT"
     }
   }
 }
diff --git a/package.json b/package.json
index fa4a1585a..9b634c3cb 100644
--- a/package.json
+++ b/package.json
@@ -61,11 +61,11 @@
   "devDependencies": {
     "@analogjs/vite-plugin-angular": "1.19.1",
     "@analogjs/vitest-angular": "1.19.1",
-    "@angular-devkit/build-angular": "20.1.1",
+    "@angular-devkit/build-angular": "^20.3.6",
     "@angular-devkit/core": "20.1.1",
     "@angular-devkit/schematics": "20.1.1",
-    "@angular/build": "20.1.1",
-    "@angular/cli": "~20.1.0",
+    "@angular/build": "^20.3.6",
+    "@angular/cli": "^20.3.6",
     "@angular/compiler-cli": "20.1.2",
     "@angular/language-service": "20.1.2",
     "@angular/pwa": "20.1.1",
diff --git a/tsconfig.base.json b/tsconfig.base.json
index 014bdf195..58f90be84 100644
--- a/tsconfig.base.json
+++ b/tsconfig.base.json
@@ -47,6 +47,9 @@
       "@isa/checkout/feature/reward-catalog": [
         "libs/checkout/feature/reward-catalog/src/index.ts"
       ],
+      "@isa/checkout/feature/reward-order-confirmation": [
+        "libs/checkout/feature/reward-order-confirmation/src/index.ts"
+      ],
       "@isa/checkout/feature/reward-shopping-cart": [
         "libs/checkout/feature/reward-shopping-cart/src/index.ts"
       ],