🌟 Overview

Foundry core is an enterprise-grade, Material-free infrastructure and UI core library designed for Angular applications. It acts as the "brain" of the Foundry suite, providing a robust architecture for networking, security, global state, and dynamic UI components without relying on heavy third-party UI frameworks.

🚀 Key features & philosophy

• Material-free: 100% native Angular DOM manipulation (createComponent, ApplicationRef). It completely avoids Angular Material and the CDK to ensure a minimal footprint and ultimate performance.

• Enterprise-ready: Built-in memory leak prevention, RxJS reactivity, Zone.js optimizations (runOutsideAngular), and advanced concurrency controls.

• Plug & play: Includes ready-to-use default components (like confirmation dialogs and loaders) that require zero HTML boilerplate from the consuming application.

• SSR compatible: Safely interacts with the DOM using Angular's environment injectors, ensuring compatibility with Server-Side Rendering.

📦 Installation

Install the package via npm:

npm install @antoniocorraliza/foundry-core

🧩 Architecture & ecosystem

The library is meticulously structured into highly cohesive modules to handle complex application logic seamlessly:

• Network: Advanced HTTP client (FoundryHttpClientService) with automated request dispatching, standardized error mapping, and interceptors (API prefixing, auto-loader, and mutex-locked token refresh).

• Security: Comprehensive JWT management, authentication contexts, and a plug-and-play refresh token provider (FoundryRefreshTokenProvider).

• User interface: Dynamic, zero-dependency UI managers for Modals (FoundryDialogWindowService), Notifications (FoundryNotificationService), and Global Loaders directly injected into the DOM.

• State: Cross-tab synchronization via FoundryBroadcastChannelService to keep multiple browser windows perfectly synced in real-time.

• Storage: Strictly typed, serialized browser storage engine wrapper (FoundryBrowserStorageService).

• Config & errors: Runtime application configuration loading (FoundryConfigurationService) and a global error handler (FoundryGlobalErrorHandler) for unhandled exceptions.

• Routing: Robust navigation wrapper (FoundryRouterService) to safely handle query parameters, navigation state, and tab-management.

💻 Integration Examples

For comprehensive documentation, advanced use cases, and fully developed integration examples across the entire core ecosystem, please visit our official site:

🌐 https://www.foundry-suite.com

🛡️ Peer dependencies

This suite is built on top of the latest Angular features. Make sure your environment satisfies the following:

• @angular/core: >=19.2.0

• @angular/common: >=19.2.0

📄 License

Property of Antonio Corraliza León as part of the Foundry development suite. All rights reserved.