@gnggln/ng-ui-system 1.0.0-alpha.2 → 1.0.0-alpha.21

package/fesm2022/gnggln-ng-ui-system-http.mjs

@@ -0,0 +1,1878 @@
+import * as i0 from '@angular/core';
+import { EventEmitter, Component, ChangeDetectionStrategy, ViewEncapsulation, Input, Output, inject, ChangeDetectorRef, ApplicationRef, EnvironmentInjector, createComponent, Injectable, PLATFORM_ID, InjectionToken, NgZone } from '@angular/core';
+import { HttpClient, HttpHeaders } from '@angular/common/http';
+import { BehaviorSubject, Subject, throwError } from 'rxjs';
+import { filter, takeUntil, map, catchError, finalize } from 'rxjs/operators';
+import { CommonModule, DOCUMENT, isPlatformBrowser } from '@angular/common';
+import * as i1 from 'lucide-angular';
+import { LucideAngularModule } from 'lucide-angular';
+import { Router, NavigationEnd } from '@angular/router';
+
+/**
+ * Shared utility functions for ng-ui-system components.
+ */
+/**
+ * Generates a unique ID with an optional prefix.
+ * Uses crypto.randomUUID() when available for better randomness, falls back to crypto.getRandomValues().
+ * Useful for linking labels to form controls, ARIA attributes, etc.
+ *
+ * @param prefix - Optional prefix for the generated ID.
+ * @returns A unique string ID.
+ */
+function uiUniqueId(prefix = 'ui') {
+    let randomPart;
+    // Try crypto.randomUUID() first (modern browsers/Node 19+)
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        randomPart = crypto.randomUUID().substring(0, 8);
+    }
+    // Fallback to crypto.getRandomValues()
+    else if (typeof crypto !== 'undefined' && crypto.getRandomValues) {
+        const array = new Uint8Array(4);
+        crypto.getRandomValues(array);
+        randomPart = Array.from(array, (byte) => byte.toString(36))
+            .join('')
+            .substring(0, 8);
+    }
+    // Final fallback to Math.random() for older environments
+    else {
+        randomPart = Math.random().toString(36).substring(2, 9); // NOSONAR - Fallback for environments without crypto API
+    }
+    return `${prefix}-${randomPart}`;
+}
+/**
+ * Coerces a value to a boolean.
+ * Useful for handling string boolean attributes in templates.
+ *
+ * @param value - The value to coerce.
+ * @returns The boolean representation.
+ */
+function uiCoerceBoolean(value) {
+    return value != null && `${value}` !== 'false';
+}
+/**
+ * Clamps a number between a minimum and maximum value.
+ *
+ * @param value - The value to clamp.
+ * @param min - The minimum allowed value.
+ * @param max - The maximum allowed value.
+ * @returns The clamped value.
+ */
+function uiClamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+/**
+ * Removes all `null` and `undefined` values from an object.
+ * Returns a new object — the original is not mutated.
+ *
+ * @param obj - The source object.
+ * @returns A shallow copy with nullish entries removed.
+ *
+ * @example
+ * ```typescript
+ * uiFilterNullish({ a: 1, b: null, c: 'x', d: undefined });
+ * // → { a: 1, c: 'x' }
+ * ```
+ */
+function uiFilterNullish(obj) {
+    return Object.entries(obj)
+        .filter(([, value]) => value !== null && value !== undefined)
+        .reduce((acc, [key, value]) => ({ ...acc, [key]: value }), {});
+}
+/**
+ * Converts a key-value object into a URL query string.
+ * Nullish values are filtered out automatically.
+ *
+ * @param params - Query parameter object.
+ * @returns A query string like `?key=value&key2=value2`, or an empty string if no params.
+ *
+ * @example
+ * ```typescript
+ * uiQueryParamsToPath({ search: 'test', page: 1, active: true });
+ * // → '?search=test&page=1&active=true'
+ *
+ * uiQueryParamsToPath(undefined);
+ * // → ''
+ * ```
+ */
+function uiQueryParamsToPath(params) {
+    if (!params)
+        return '';
+    const searchParams = new URLSearchParams();
+    Object.entries(uiFilterNullish(params)).forEach(([key, value]) => {
+        if (Array.isArray(value)) {
+            value.forEach((v) => searchParams.append(key, String(v ?? '')));
+        }
+        else {
+            searchParams.append(key, String(value ?? ''));
+        }
+    });
+    const str = searchParams.toString();
+    return str ? `?${str}` : '';
+}
+
+/**
+ * @module ng-ui-system/toast
+ * Types and interfaces for the proprietary toast notification system.
+ */
+/** Defaults applied to every toast unless overridden. */
+const UI_TOAST_DEFAULTS = {
+    duration: 5000,
+    position: 'top-right',
+    dismissible: true,
+    enableHtml: false,
+};
+
+/**
+ * Individual toast notification element.
+ *
+ * Rendered dynamically by `UiToastContainerComponent`.
+ * Handles its own enter/exit CSS animations and auto-dismiss countdown.
+ *
+ * @selector ui-toast
+ * @internal Not intended for direct use — managed by `UiToastService`.
+ */
+class UiToastComponent {
+    constructor() {
+        /** Toast message text. */
+        this.message = '';
+        /** Toast type for styling. */
+        this.type = 'info';
+        /** Animation state. */
+        this.state = 'entering';
+        /** Whether the close button is shown. */
+        this.dismissible = true;
+        /** Whether HTML rendering is enabled. */
+        this.enableHtml = false;
+        /** Emitted when the user clicks the dismiss button. */
+        this.dismissed = new EventEmitter();
+    }
+    /** Resolved icon name based on type. */
+    get resolvedIcon() {
+        if (this.icon)
+            return this.icon;
+        switch (this.type) {
+            case 'success': return 'check-circle';
+            case 'error': return 'x-circle';
+            case 'warning': return 'alert-triangle';
+            case 'info':
+            default: return 'info';
+        }
+    }
+    ngOnInit() {
+        // Transition from entering → visible after the CSS animation completes
+        this.enterTimeout = setTimeout(() => {
+            this.state = 'visible';
+        }, 320);
+    }
+    ngOnDestroy() {
+        if (this.enterTimeout)
+            clearTimeout(this.enterTimeout);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiToastComponent, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "18.2.14", type: UiToastComponent, isStandalone: true, selector: "ui-toast", inputs: { message: "message", type: "type", state: "state", dismissible: "dismissible", enableHtml: "enableHtml", icon: "icon", customClass: "customClass" }, outputs: { dismissed: "dismissed" }, host: { classAttribute: "ui-toast-host" }, ngImport: i0, template: `
+    <div
+      class="ui-toast {{ customClass || '' }}"
+      [class.ui-toast--success]="type === 'success'"
+      [class.ui-toast--error]="type === 'error'"
+      [class.ui-toast--warning]="type === 'warning'"
+      [class.ui-toast--info]="type === 'info'"
+      [class.ui-toast--entering]="state === 'entering'"
+      [class.ui-toast--visible]="state === 'visible'"
+      [class.ui-toast--exiting]="state === 'exiting'"
+      role="alert"
+      aria-live="assertive"
+      aria-atomic="true"
+    >
+      <div class="ui-toast__icon">
+        <lucide-icon [name]="resolvedIcon" [size]="20"></lucide-icon>
+      </div>
+
+      <div class="ui-toast__content">
+        @if (enableHtml) {
+          <span class="ui-toast__message" [innerHTML]="message"></span>
+        } @else {
+          <span class="ui-toast__message">{{ message }}</span>
+        }
+      </div>
+
+      @if (dismissible) {
+        <button
+          class="ui-toast__close"
+          type="button"
+          (click)="dismissed.emit()"
+          aria-label="Chiudi notifica"
+        >
+          <lucide-icon name="x" [size]="16"></lucide-icon>
+        </button>
+      }
+    </div>
+  `, isInline: true, styles: [".ui-toast-host{display:contents}.ui-toast{display:flex;align-items:flex-start;gap:var(--ui-spacing-3, 12px);padding:var(--ui-spacing-3, 12px) var(--ui-spacing-4, 16px);border-radius:var(--ui-radius-md, 8px);min-width:320px;max-width:440px;font-family:var(--ui-font-family, \"Inter\", sans-serif);font-size:var(--ui-font-size-sm, .875rem);font-weight:400;line-height:1.5;color:var(--ui-color-neutral-900, #111827);background:var(--ui-color-surface, #ffffff);border:1px solid var(--ui-color-neutral-200, #e5e7eb);box-shadow:var(--ui-shadow-md);pointer-events:auto;position:relative;overflow:hidden}.ui-toast:before{content:\"\";position:absolute;top:0;bottom:0;left:0;width:4px;background:transparent}.ui-toast--entering{animation:ui-toast-slide-in .25s cubic-bezier(.2,0,0,1) forwards}.ui-toast--visible{opacity:1;transform:translate(0)}.ui-toast--exiting{animation:ui-toast-slide-out .2s cubic-bezier(.4,0,1,1) forwards}.ui-toast--success:before{background:var(--ui-color-success, #10b981)}.ui-toast--success .ui-toast__icon{color:var(--ui-color-success, #10b981)}.ui-toast--error:before{background:var(--ui-color-warn, #ef4444)}.ui-toast--error .ui-toast__icon{color:var(--ui-color-warn, #ef4444)}.ui-toast--warning:before{background:var(--ui-color-warning, #f59e0b)}.ui-toast--warning .ui-toast__icon{color:var(--ui-color-warning, #f59e0b)}.ui-toast--info:before{background:var(--ui-color-info, #3b82f6)}.ui-toast--info .ui-toast__icon{color:var(--ui-color-info, #3b82f6)}.ui-toast__icon{flex-shrink:0;display:flex;align-items:center;justify-content:center;width:20px;height:20px;margin-top:2px}.ui-toast__content{flex:1;min-width:0;display:flex;flex-direction:column;justify-content:center;min-height:20px}.ui-toast__message{word-break:break-word;margin:0}.ui-toast__close{flex-shrink:0;display:flex;align-items:center;justify-content:center;width:24px;height:24px;padding:0;margin:0 -4px 0 0;border:none;border-radius:var(--ui-radius-sm, 4px);background:transparent;color:var(--ui-color-neutral-400, #9ca3af);cursor:pointer;transition-property:background,color;transition-duration:var(--ui-transition-fast);transition-timing-function:ease}.ui-toast__close:hover{background:var(--ui-color-neutral-100, #f3f4f6);color:var(--ui-color-neutral-700, #374151)}.ui-toast__close:focus{outline:none}.ui-toast__close:focus-visible{outline:var(--ui-focus-ring-width) solid var(--ui-focus-ring-color);outline-offset:var(--ui-focus-ring-offset)}@keyframes ui-toast-slide-in{0%{opacity:0;transform:translate(100%)}to{opacity:1;transform:translate(0)}}@keyframes ui-toast-slide-out{0%{opacity:1;transform:translate(0)}to{opacity:0;transform:translate(100%)}}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "ngmodule", type: LucideAngularModule }, { kind: "component", type: i1.LucideAngularComponent, selector: "lucide-angular, lucide-icon, i-lucide, span-lucide", inputs: ["class", "name", "img", "color", "absoluteStrokeWidth", "size", "strokeWidth"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush, encapsulation: i0.ViewEncapsulation.None }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiToastComponent, decorators: [{
+            type: Component,
+            args: [{ selector: 'ui-toast', standalone: true, imports: [CommonModule, LucideAngularModule], changeDetection: ChangeDetectionStrategy.OnPush, encapsulation: ViewEncapsulation.None, host: {
+                        'class': 'ui-toast-host',
+                    }, template: `
+    <div
+      class="ui-toast {{ customClass || '' }}"
+      [class.ui-toast--success]="type === 'success'"
+      [class.ui-toast--error]="type === 'error'"
+      [class.ui-toast--warning]="type === 'warning'"
+      [class.ui-toast--info]="type === 'info'"
+      [class.ui-toast--entering]="state === 'entering'"
+      [class.ui-toast--visible]="state === 'visible'"
+      [class.ui-toast--exiting]="state === 'exiting'"
+      role="alert"
+      aria-live="assertive"
+      aria-atomic="true"
+    >
+      <div class="ui-toast__icon">
+        <lucide-icon [name]="resolvedIcon" [size]="20"></lucide-icon>
+      </div>
+
+      <div class="ui-toast__content">
+        @if (enableHtml) {
+          <span class="ui-toast__message" [innerHTML]="message"></span>
+        } @else {
+          <span class="ui-toast__message">{{ message }}</span>
+        }
+      </div>
+
+      @if (dismissible) {
+        <button
+          class="ui-toast__close"
+          type="button"
+          (click)="dismissed.emit()"
+          aria-label="Chiudi notifica"
+        >
+          <lucide-icon name="x" [size]="16"></lucide-icon>
+        </button>
+      }
+    </div>
+  `, styles: [".ui-toast-host{display:contents}.ui-toast{display:flex;align-items:flex-start;gap:var(--ui-spacing-3, 12px);padding:var(--ui-spacing-3, 12px) var(--ui-spacing-4, 16px);border-radius:var(--ui-radius-md, 8px);min-width:320px;max-width:440px;font-family:var(--ui-font-family, \"Inter\", sans-serif);font-size:var(--ui-font-size-sm, .875rem);font-weight:400;line-height:1.5;color:var(--ui-color-neutral-900, #111827);background:var(--ui-color-surface, #ffffff);border:1px solid var(--ui-color-neutral-200, #e5e7eb);box-shadow:var(--ui-shadow-md);pointer-events:auto;position:relative;overflow:hidden}.ui-toast:before{content:\"\";position:absolute;top:0;bottom:0;left:0;width:4px;background:transparent}.ui-toast--entering{animation:ui-toast-slide-in .25s cubic-bezier(.2,0,0,1) forwards}.ui-toast--visible{opacity:1;transform:translate(0)}.ui-toast--exiting{animation:ui-toast-slide-out .2s cubic-bezier(.4,0,1,1) forwards}.ui-toast--success:before{background:var(--ui-color-success, #10b981)}.ui-toast--success .ui-toast__icon{color:var(--ui-color-success, #10b981)}.ui-toast--error:before{background:var(--ui-color-warn, #ef4444)}.ui-toast--error .ui-toast__icon{color:var(--ui-color-warn, #ef4444)}.ui-toast--warning:before{background:var(--ui-color-warning, #f59e0b)}.ui-toast--warning .ui-toast__icon{color:var(--ui-color-warning, #f59e0b)}.ui-toast--info:before{background:var(--ui-color-info, #3b82f6)}.ui-toast--info .ui-toast__icon{color:var(--ui-color-info, #3b82f6)}.ui-toast__icon{flex-shrink:0;display:flex;align-items:center;justify-content:center;width:20px;height:20px;margin-top:2px}.ui-toast__content{flex:1;min-width:0;display:flex;flex-direction:column;justify-content:center;min-height:20px}.ui-toast__message{word-break:break-word;margin:0}.ui-toast__close{flex-shrink:0;display:flex;align-items:center;justify-content:center;width:24px;height:24px;padding:0;margin:0 -4px 0 0;border:none;border-radius:var(--ui-radius-sm, 4px);background:transparent;color:var(--ui-color-neutral-400, #9ca3af);cursor:pointer;transition-property:background,color;transition-duration:var(--ui-transition-fast);transition-timing-function:ease}.ui-toast__close:hover{background:var(--ui-color-neutral-100, #f3f4f6);color:var(--ui-color-neutral-700, #374151)}.ui-toast__close:focus{outline:none}.ui-toast__close:focus-visible{outline:var(--ui-focus-ring-width) solid var(--ui-focus-ring-color);outline-offset:var(--ui-focus-ring-offset)}@keyframes ui-toast-slide-in{0%{opacity:0;transform:translate(100%)}to{opacity:1;transform:translate(0)}}@keyframes ui-toast-slide-out{0%{opacity:1;transform:translate(0)}to{opacity:0;transform:translate(100%)}}\n"] }]
+        }], propDecorators: { message: [{
+                type: Input
+            }], type: [{
+                type: Input
+            }], state: [{
+                type: Input
+            }], dismissible: [{
+                type: Input
+            }], enableHtml: [{
+                type: Input
+            }], icon: [{
+                type: Input
+            }], customClass: [{
+                type: Input
+            }], dismissed: [{
+                type: Output
+            }] } });
+
+/**
+ * Toast container — manages stacking and positioning of active toasts.
+ *
+ * Dynamically attached to the DOM by `UiToastService` on first use.
+ * Renders one `ui-toast` per active notification.
+ *
+ * @selector ui-toast-container
+ * @internal Not intended for direct use.
+ */
+class UiToastContainerComponent {
+    constructor() {
+        this.cdr = inject(ChangeDetectorRef);
+        /** Active toasts — managed by UiToastService. */
+        this.toasts = [];
+    }
+    /** Called by UiToastService to add a toast. */
+    addToast(toast) {
+        this.toasts = [...this.toasts, toast];
+        this.cdr.markForCheck();
+    }
+    /** Called by UiToastService to remove a toast. */
+    removeToast(id) {
+        this.toasts = this.toasts.filter(t => t.id !== id);
+        this.cdr.markForCheck();
+    }
+    /** Update a toast's state (e.g. entering → exiting). */
+    updateToastState(id, state) {
+        const toast = this.toasts.find(t => t.id === id);
+        if (toast) {
+            toast.state = state;
+            this.cdr.markForCheck();
+        }
+    }
+    /** Dismiss handler from the toast component. */
+    onDismiss(toast) {
+        // This is handled by the service via dismiss()
+        if (toast.timeoutId)
+            clearTimeout(toast.timeoutId);
+        this.updateToastState(toast.id, 'exiting');
+        setTimeout(() => this.removeToast(toast.id), 260);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiToastContainerComponent, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "18.2.14", type: UiToastContainerComponent, isStandalone: true, selector: "ui-toast-container", host: { classAttribute: "ui-toast-container-host" }, ngImport: i0, template: `
+    @for (toast of toasts; track toast.id) {
+      <ui-toast
+        [message]="toast.message"
+        [type]="toast.type"
+        [state]="toast.state"
+        [dismissible]="toast.config.dismissible"
+        [enableHtml]="toast.config.enableHtml"
+        [icon]="toast.config.icon"
+        [customClass]="toast.config.customClass"
+        (dismissed)="onDismiss(toast)"
+      />
+    }
+  `, isInline: true, styles: [".ui-toast-container-host{position:fixed;z-index:10000;pointer-events:none;display:flex;flex-direction:column;gap:var(--ui-spacing-3, 12px);padding:var(--ui-spacing-6, 24px);max-height:100vh;overflow:hidden;top:0;right:0;align-items:flex-end}.ui-toast-container-host--top-right{top:0;right:0;align-items:flex-end}.ui-toast-container-host--top-left{top:0;left:0;align-items:flex-start}.ui-toast-container-host--bottom-right{top:auto;bottom:0;right:0;align-items:flex-end;flex-direction:column-reverse}.ui-toast-container-host--bottom-left{top:auto;bottom:0;left:0;align-items:flex-start;flex-direction:column-reverse}.ui-toast-container-host--top-center{top:0;left:50%;right:auto;transform:translate(-50%);align-items:center}.ui-toast-container-host--bottom-center{inset:auto auto 0 50%;transform:translate(-50%);align-items:center;flex-direction:column-reverse}\n"], dependencies: [{ kind: "component", type: UiToastComponent, selector: "ui-toast", inputs: ["message", "type", "state", "dismissible", "enableHtml", "icon", "customClass"], outputs: ["dismissed"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush, encapsulation: i0.ViewEncapsulation.None }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiToastContainerComponent, decorators: [{
+            type: Component,
+            args: [{ selector: 'ui-toast-container', standalone: true, imports: [UiToastComponent], changeDetection: ChangeDetectionStrategy.OnPush, encapsulation: ViewEncapsulation.None, host: {
+                        'class': 'ui-toast-container-host',
+                    }, template: `
+    @for (toast of toasts; track toast.id) {
+      <ui-toast
+        [message]="toast.message"
+        [type]="toast.type"
+        [state]="toast.state"
+        [dismissible]="toast.config.dismissible"
+        [enableHtml]="toast.config.enableHtml"
+        [icon]="toast.config.icon"
+        [customClass]="toast.config.customClass"
+        (dismissed)="onDismiss(toast)"
+      />
+    }
+  `, styles: [".ui-toast-container-host{position:fixed;z-index:10000;pointer-events:none;display:flex;flex-direction:column;gap:var(--ui-spacing-3, 12px);padding:var(--ui-spacing-6, 24px);max-height:100vh;overflow:hidden;top:0;right:0;align-items:flex-end}.ui-toast-container-host--top-right{top:0;right:0;align-items:flex-end}.ui-toast-container-host--top-left{top:0;left:0;align-items:flex-start}.ui-toast-container-host--bottom-right{top:auto;bottom:0;right:0;align-items:flex-end;flex-direction:column-reverse}.ui-toast-container-host--bottom-left{top:auto;bottom:0;left:0;align-items:flex-start;flex-direction:column-reverse}.ui-toast-container-host--top-center{top:0;left:50%;right:auto;transform:translate(-50%);align-items:center}.ui-toast-container-host--bottom-center{inset:auto auto 0 50%;transform:translate(-50%);align-items:center;flex-direction:column-reverse}\n"] }]
+        }] });
+
+/**
+ * @module ng-ui-system/toast
+ * Proprietary toast notification service.
+ *
+ * Zero external dependencies — renders toast components directly into the DOM
+ * via Angular's `ApplicationRef`.
+ *
+ * @usageNotes
+ * ### Basic usage
+ * ```typescript
+ * const toast = inject(UiToastService);
+ * toast.success('Record salvato!');
+ * toast.error('Errore durante il salvataggio');
+ * ```
+ *
+ * ### With config
+ * ```typescript
+ * toast.warning('Attenzione', { duration: 8000, position: 'bottom-right' });
+ * ```
+ *
+ * ### Programmatic dismiss
+ * ```typescript
+ * const ref = toast.info('Caricamento in corso...', { duration: 0 });
+ * // ...later
+ * ref.dismiss();
+ * ```
+ *
+ * @selector —
+ */
+/**
+ * Central toast notification service.
+ *
+ * Manages a single `UiToastContainerComponent` in the DOM and provides
+ * convenience methods for showing typed notifications.
+ */
+class UiToastService {
+    constructor() {
+        this.appRef = inject(ApplicationRef);
+        this.injector = inject(EnvironmentInjector);
+        this.document = inject(DOCUMENT);
+        /** Reference to the singleton container component. */
+        this.containerRef = null;
+    }
+    // ── Public API ─────────────────────────────────────────────────────
+    /** Show a **success** toast. */
+    success(message, config) {
+        return this.show(message, 'success', config);
+    }
+    /** Show an **error** toast. */
+    error(message, config) {
+        return this.show(message, 'error', config);
+    }
+    /** Show a **warning** toast. */
+    warning(message, config) {
+        return this.show(message, 'warning', config);
+    }
+    /** Show an **info** toast. */
+    info(message, config) {
+        return this.show(message, 'info', config);
+    }
+    /** Show a toast with explicit type. */
+    show(message, type = 'info', config) {
+        this.ensureContainer(config?.position);
+        const container = this.containerRef.instance;
+        const id = uiUniqueId('toast');
+        const merged = {
+            ...UI_TOAST_DEFAULTS,
+            ...config,
+        };
+        const data = {
+            id,
+            message,
+            type: config?.type ?? type,
+            config: merged,
+            state: 'entering',
+        };
+        // Auto-dismiss
+        if (merged.duration > 0) {
+            data.timeoutId = setTimeout(() => this.dismiss(id), merged.duration);
+        }
+        container.addToast(data);
+        return {
+            id,
+            dismiss: () => this.dismiss(id),
+        };
+    }
+    /** Dismiss a specific toast by ID. */
+    dismiss(id) {
+        const container = this.containerRef?.instance;
+        if (!container)
+            return;
+        const toast = container.toasts.find(t => t.id === id);
+        if (!toast || toast.state === 'exiting')
+            return;
+        if (toast.timeoutId)
+            clearTimeout(toast.timeoutId);
+        // Animate out, then remove
+        container.updateToastState(id, 'exiting');
+        setTimeout(() => container.removeToast(id), 260);
+    }
+    /** Dismiss all active toasts. */
+    dismissAll() {
+        const container = this.containerRef?.instance;
+        if (!container)
+            return;
+        const ids = container.toasts.map(t => t.id);
+        ids.forEach(id => this.dismiss(id));
+    }
+    // ── Internals ──────────────────────────────────────────────────────
+    /**
+     * Ensures the container component exists in the DOM.
+     * Creates it lazily on first toast call.
+     */
+    ensureContainer(position) {
+        if (this.containerRef) {
+            // Update position class if needed
+            if (position) {
+                const el = this.containerRef.location.nativeElement;
+                this.applyPositionClass(el, position);
+            }
+            return;
+        }
+        // Create the container component dynamically
+        this.containerRef = createComponent(UiToastContainerComponent, {
+            environmentInjector: this.injector,
+        });
+        // Attach to Angular's change detection
+        this.appRef.attachView(this.containerRef.hostView);
+        // Insert into the DOM
+        const el = this.containerRef.location.nativeElement;
+        this.applyPositionClass(el, position ?? UI_TOAST_DEFAULTS.position);
+        this.document.body.appendChild(el);
+    }
+    /** Apply CSS position modifier class to the container element. */
+    applyPositionClass(el, position) {
+        // Remove old position classes
+        el.className = el.className
+            .split(' ')
+            .filter(c => !c.startsWith('ui-toast-container-host--'))
+            .join(' ');
+        el.classList.add(`ui-toast-container-host--${position}`);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiToastService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiToastService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiToastService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * Central service for programmatic control of the `ui-layout-builder` shell.
+ *
+ * Provides reactive state management for:
+ * - Overlay loader (with body scroll locking)
+ * - Sidebar open / collapsed state
+ * - Context-sensitive FAB actions
+ * - Navigation badge and visibility overrides
+ * - Layout mode switching (sidebar / topbar / slotted)
+ * - Content type (fluid / boxed / fullscreen)
+ * - Topbar bar visibility (notification bars show/hide)
+ *
+ * @example
+ * ```typescript
+ * export class MyPageComponent {
+ *   private layout = inject(UiLayoutService);
+ *
+ *   async loadData() {
+ *     this.layout.showLoader();
+ *     try {
+ *       await this.api.fetchAll();
+ *     } finally {
+ *       this.layout.hideLoader();
+ *     }
+ *   }
+ * }
+ * ```
+ */
+class UiLayoutService {
+    constructor() {
+        this.platformId = inject(PLATFORM_ID);
+        // ── Loader ───────────────────────────────────────────────────────
+        this._loading$ = new BehaviorSubject(false);
+        /** Whether the overlay loader is currently visible. */
+        this.loading$ = this._loading$.asObservable();
+        // ── Layout Mode ─────────────────────────────────────────────────
+        this._layoutMode$ = new BehaviorSubject('sidebar');
+        /** Current layout mode (sidebar or topbar). */
+        this.layoutMode$ = this._layoutMode$.asObservable();
+        // ── Content Type ────────────────────────────────────────────────
+        this._contentType$ = new BehaviorSubject('fluid');
+        /** Current content type (fluid, boxed, fullscreen). */
+        this.contentType$ = this._contentType$.asObservable();
+        // ── Sidebar ──────────────────────────────────────────────────────
+        this._sidebarOpen$ = new BehaviorSubject(false);
+        /** Whether the mobile sidebar drawer is open. */
+        this.sidebarOpen$ = this._sidebarOpen$.asObservable();
+        this._sidebarCollapsed$ = new BehaviorSubject(false);
+        /** Whether the desktop sidebar is in collapsed (icon-only) mode. */
+        this.sidebarCollapsed$ = this._sidebarCollapsed$.asObservable();
+        // ── FAB (context-sensitive) ──────────────────────────────────────
+        this._defaultFabConfig = null;
+        this._fabConfig$ = new BehaviorSubject(null);
+        /** Current FAB configuration (schema default merged with page overrides). */
+        this.fabConfig$ = this._fabConfig$.asObservable();
+        // ── Navigation helpers ───────────────────────────────────────────
+        this._navBadges$ = new BehaviorSubject(new Map());
+        /** Observable map of nav-item badges keyed by item ID. */
+        this.navBadges$ = this._navBadges$.asObservable();
+        this._navVisibility$ = new BehaviorSubject(new Map());
+        /** Observable map of nav-item visibility overrides keyed by item ID. */
+        this.navVisibility$ = this._navVisibility$.asObservable();
+        // ── Bar visibility (topbar notification bars) ───────────────────
+        this._barVisibility$ = new BehaviorSubject(new Map());
+        /** Observable map of topbar bar visibility keyed by bar ID. */
+        this.barVisibility$ = this._barVisibility$.asObservable();
+    }
+    /** Show the full-screen overlay loader and block body scroll. */
+    showLoader() {
+        this._loading$.next(true);
+        this.setBodyOverflow(true);
+    }
+    /** Hide the overlay loader and restore body scroll. */
+    hideLoader() {
+        this._loading$.next(false);
+        this.setBodyOverflow(false);
+    }
+    /** Toggle the overlay loader. */
+    toggleLoader() {
+        if (this._loading$.value) {
+            this.hideLoader();
+        }
+        else {
+            this.showLoader();
+        }
+    }
+    /** Synchronous snapshot of the loading state. */
+    isLoading() {
+        return this._loading$.value;
+    }
+    /**
+     * Switch layout mode with loader masking the transition.
+     * Shows the loader, applies the mode change, then hides the loader
+     * after a short delay to prevent visible layout shift.
+     */
+    setLayoutMode(mode, transitionMs = 300) {
+        if (this._layoutMode$.value === mode)
+            return;
+        this.showLoader();
+        this._layoutMode$.next(mode);
+        setTimeout(() => this.hideLoader(), transitionMs);
+    }
+    /** Synchronous snapshot of the current layout mode. */
+    getLayoutMode() {
+        return this._layoutMode$.value;
+    }
+    /**
+     * @internal Called by the layout-builder component to set the initial mode
+     * from the schema without triggering the loader transition.
+     */
+    _setInitialLayoutMode(mode) {
+        this._layoutMode$.next(mode);
+    }
+    /** Set the content type per-route or globally. */
+    setContentType(type) {
+        this._contentType$.next(type);
+    }
+    /** Synchronous snapshot of the current content type. */
+    getContentType() {
+        return this._contentType$.value;
+    }
+    /** @internal */
+    _setInitialContentType(type) {
+        this._contentType$.next(type);
+    }
+    /** Toggle the desktop sidebar between expanded and collapsed. */
+    toggleSidebar() {
+        this._sidebarCollapsed$.next(!this._sidebarCollapsed$.value);
+    }
+    /** Set the desktop sidebar collapsed state explicitly. */
+    collapseSidebar(collapsed = true) {
+        this._sidebarCollapsed$.next(collapsed);
+    }
+    /** Open the mobile sidebar drawer. */
+    openMobileSidebar() {
+        this._sidebarOpen$.next(true);
+    }
+    /** Close the mobile sidebar drawer. */
+    closeMobileSidebar() {
+        this._sidebarOpen$.next(false);
+    }
+    /** Synchronous snapshot: is the mobile sidebar open? */
+    isSidebarOpen() {
+        return this._sidebarOpen$.value;
+    }
+    /** Synchronous snapshot: is the desktop sidebar collapsed? */
+    isSidebarCollapsed() {
+        return this._sidebarCollapsed$.value;
+    }
+    /**
+     * Called internally by the layout-builder component to register the
+     * schema-level default FAB config.
+     * @internal
+     */
+    _setDefaultFabConfig(config) {
+        this._defaultFabConfig = config;
+        this._fabConfig$.next(config);
+    }
+    /** Override the FAB main action for the current page context. */
+    setMainFabAction(action) {
+        const current = this._fabConfig$.value;
+        this._fabConfig$.next({
+            mainAction: action,
+            secondaryActions: current?.secondaryActions ?? [],
+            position: current?.position ?? 'bottom-right',
+        });
+    }
+    /** Override all FAB actions for the current page context. */
+    setFabActions(main, secondary) {
+        const current = this._fabConfig$.value;
+        this._fabConfig$.next({
+            mainAction: main,
+            secondaryActions: secondary ?? [],
+            position: current?.position ?? 'bottom-right',
+        });
+    }
+    /** Reset FAB to the schema-level default configuration. */
+    clearFabActions() {
+        this._fabConfig$.next(this._defaultFabConfig);
+    }
+    /** Set or clear a badge on a navigation item. Pass `null` to remove. */
+    setNavBadge(itemId, badge) {
+        const map = new Map(this._navBadges$.value);
+        if (badge === null) {
+            map.delete(itemId);
+        }
+        else {
+            map.set(itemId, badge);
+        }
+        this._navBadges$.next(map);
+    }
+    /** Override visibility of a navigation item. */
+    setNavItemVisibility(itemId, visible) {
+        const map = new Map(this._navVisibility$.value);
+        map.set(itemId, visible);
+        this._navVisibility$.next(map);
+    }
+    /** Show a topbar bar by ID. */
+    showBar(barId) {
+        const map = new Map(this._barVisibility$.value);
+        map.set(barId, true);
+        this._barVisibility$.next(map);
+    }
+    /** Hide a topbar bar by ID. */
+    hideBar(barId) {
+        const map = new Map(this._barVisibility$.value);
+        map.set(barId, false);
+        this._barVisibility$.next(map);
+    }
+    /** Toggle visibility of a topbar bar by ID. */
+    toggleBar(barId) {
+        const map = new Map(this._barVisibility$.value);
+        const current = map.get(barId);
+        map.set(barId, current === undefined ? false : !current);
+        this._barVisibility$.next(map);
+    }
+    /** Synchronous check of bar visibility (schema `visible` fallback). */
+    isBarVisible(barId, schemaVisible = true) {
+        const override = this._barVisibility$.value.get(barId);
+        return override !== undefined ? override : schemaVisible;
+    }
+    // ── Private helpers ──────────────────────────────────────────────
+    setBodyOverflow(locked) {
+        if (isPlatformBrowser(this.platformId)) {
+            document.body.style.overflow = locked ? 'hidden' : '';
+        }
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiLayoutService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiLayoutService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiLayoutService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * @module ng-ui-system/http
+ * Message handler — coordinates toast notifications and loader state
+ * for the HTTP service pipeline.
+ *
+ * Extracted as a standalone injectable so it can be tested independently
+ * and potentially reused outside HTTP flows.
+ */
+/**
+ * Orchestrates toast notifications and loader state for HTTP requests.
+ *
+ * Features:
+ * - Debounce anti-spam (groups identical messages within 300ms)
+ * - Inline message resolution with placeholder replacements
+ * - `successMessageResolver` / `errorExtractor` for dynamic messages
+ * - Loader integration via `UiLayoutService` (optional)
+ */
+class UiHttpMessageHandler {
+    constructor() {
+        this.toast = inject(UiToastService);
+        this.layout = inject(UiLayoutService, { optional: true });
+        /** Debounce time in milliseconds. */
+        this.DEBOUNCE_TIME = 300;
+        /** Active debounce timeouts keyed by message content. */
+        this.messageTimeouts = new Map();
+    }
+    // ── Loader ─────────────────────────────────────────────────────────
+    /** Show the global loader (via UiLayoutService if available). */
+    startLoading() {
+        this.layout?.showLoader();
+    }
+    /** Hide the global loader. */
+    stopLoading() {
+        this.layout?.hideLoader();
+    }
+    // ── Success ────────────────────────────────────────────────────────
+    /**
+     * Show a success toast for the given endpoint.
+     *
+     * Resolution priority:
+     * 1. `successMessageResolver()` if provided and returns non-null
+     * 2. `messages.success` with placeholder replacements
+     * 3. No toast if no message is configured
+     */
+    showSuccess(endpoint) {
+        if (!endpoint.showSuccess)
+            return;
+        let message = null;
+        // Priority 1: custom resolver
+        if (endpoint.successMessageResolver) {
+            message = endpoint.successMessageResolver();
+        }
+        // Priority 2: inline message with replacements
+        if (!message && endpoint.messages?.success) {
+            message = this.applyReplacements(endpoint.messages.success, endpoint.replacements);
+        }
+        if (message) {
+            this.debounceToast(message, 'success');
+        }
+    }
+    // ── Error ──────────────────────────────────────────────────────────
+    /**
+     * Show an error toast for the given endpoint.
+     *
+     * Resolution priority:
+     * 1. `errorExtractor(error)` if provided and returns non-null
+     * 2. `messages.error` with placeholder replacements
+     * 3. `fallbackMessage` if everything else is empty
+     */
+    showError(endpoint, error, fallbackMessage) {
+        if (!endpoint.showError)
+            return;
+        let message = null;
+        // Priority 1: error extractor
+        if (endpoint.errorExtractor && error) {
+            message = endpoint.errorExtractor(error);
+        }
+        // Priority 2: inline message
+        if (!message && endpoint.messages?.error) {
+            message = this.applyReplacements(endpoint.messages.error, endpoint.replacements);
+        }
+        if (message) {
+            this.debounceToast(message, 'error');
+        }
+        else if (fallbackMessage) {
+            this.debounceToast(fallbackMessage, 'error');
+        }
+    }
+    // ── Custom messages ────────────────────────────────────────────────
+    /** Show a custom success toast (not tied to an endpoint). */
+    showCustomSuccess(message) {
+        this.debounceToast(message, 'success');
+    }
+    /** Show a custom error toast (not tied to an endpoint). */
+    showCustomError(message) {
+        this.debounceToast(message, 'error');
+    }
+    // ── Cleanup ────────────────────────────────────────────────────────
+    /** Cancel all pending debounce timeouts. */
+    clearAllTimeouts() {
+        this.messageTimeouts.forEach(t => clearTimeout(t));
+        this.messageTimeouts.clear();
+    }
+    // ── Internals ──────────────────────────────────────────────────────
+    /**
+     * Debounce mechanism for toast messages.
+     * If the same message is requested within DEBOUNCE_TIME ms,
+     * only the last one is shown.
+     */
+    debounceToast(message, type) {
+        const existing = this.messageTimeouts.get(message);
+        if (existing)
+            clearTimeout(existing);
+        const timeout = setTimeout(() => {
+            this.toast[type](message);
+            this.messageTimeouts.delete(message);
+        }, this.DEBOUNCE_TIME);
+        this.messageTimeouts.set(message, timeout);
+    }
+    /**
+     * Replace `${key}` placeholders in a message string.
+     */
+    applyReplacements(message, replacements) {
+        if (!replacements)
+            return message;
+        let result = message;
+        Object.entries(replacements).forEach(([key, value]) => {
+            result = result.replace(new RegExp(`\\$\\{${key}\\}`, 'g'), String(value));
+        });
+        return result;
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiHttpMessageHandler, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiHttpMessageHandler, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiHttpMessageHandler, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * @module ng-ui-system/http
+ * Injection tokens for the HTTP orchestration service.
+ */
+/**
+ * Optional global configuration for `UiHttpService`.
+ *
+ * @usageNotes
+ * ```typescript
+ * providers: [
+ *   { provide: UI_HTTP_CONFIG, useValue: { baseUrl: '/api' } },
+ * ]
+ * ```
+ */
+const UI_HTTP_CONFIG = new InjectionToken('UI_HTTP_CONFIG');
+/**
+ * Optional headers provider for injecting custom headers (auth, correlation, etc.)
+ * into every HTTP request.
+ *
+ * @usageNotes
+ * ```typescript
+ * providers: [
+ *   { provide: UI_HEADERS_PROVIDER, useClass: MyAuthHeadersProvider },
+ * ]
+ * ```
+ */
+const UI_HEADERS_PROVIDER = new InjectionToken('UI_HEADERS_PROVIDER');
+
+/**
+ * @module ng-ui-system/blackbox
+ * Types and interfaces for the BlackBox observability service.
+ *
+ * The BlackBox service acts as a "black box recorder" for user sessions,
+ * capturing navigation, UI interactions, form events and HTTP calls
+ * in a compressed, opaque format stored in IndexedDB.
+ */
+// ─── Defaults ────────────────────────────────────────────────────────
+/** Default configuration values. */
+const UI_BLACKBOX_DEFAULTS = {
+    maxStorageMb: 50,
+    flushIntervalMs: 5000,
+    flushThreshold: 20,
+    bufferDebounceMs: 500,
+    formTracking: {
+        trackValues: false,
+        trackFocus: true,
+        trackBlur: true,
+        trackValueChanges: true,
+        trackValidation: true,
+        debounceMs: 500,
+    },
+};
+
+/**
+ * @module ng-ui-system/blackbox
+ * Fingerprint service — generates a stable device/browser hash
+ * using the open-source FingerprintJS library (MIT, no API key required).
+ *
+ * The fingerprint is computed once and cached in `localStorage` under
+ * the key `__ui_bb_fp` to avoid redundant recalculations.
+ */
+/** localStorage key for the cached fingerprint. */
+const FP_CACHE_KEY = '__ui_bb_fp';
+/**
+ * Generates and caches a stable browser/device fingerprint.
+ *
+ * Uses `@fingerprintjs/fingerprintjs` (open-source, MIT) which analyses
+ * canvas rendering, WebGL, audio context, screen properties, timezone,
+ * user-agent, and other browser signals to produce a stable hash.
+ *
+ * @usageNotes
+ * ```typescript
+ * const fp = inject(UiBlackboxFingerprintService);
+ * const hash = await fp.getFingerprint();
+ * // => "a1b2c3d4e5f6..." (stable across sessions)
+ * ```
+ */
+class UiBlackboxFingerprintService {
+    constructor() {
+        this.platformId = inject(PLATFORM_ID);
+        this.cached = null;
+    }
+    /**
+     * Returns the stable fingerprint for this device/browser.
+     *
+     * On first call, loads FingerprintJS dynamically, computes the hash,
+     * and caches it in both memory and `localStorage`.
+     * Subsequent calls return the cached value immediately.
+     */
+    async getFingerprint() {
+        // Return cached value if available
+        if (this.cached) {
+            return this.cached;
+        }
+        // SSR guard
+        if (!isPlatformBrowser(this.platformId)) {
+            return 'ssr-placeholder';
+        }
+        // Try localStorage cache first
+        try {
+            const stored = localStorage.getItem(FP_CACHE_KEY);
+            if (stored) {
+                this.cached = stored;
+                return stored;
+            }
+        }
+        catch {
+            // localStorage may be unavailable (privacy mode, quota exceeded)
+        }
+        // Compute fingerprint via FingerprintJS
+        try {
+            const FingerprintJS = await import('@fingerprintjs/fingerprintjs');
+            const agent = await FingerprintJS.load();
+            const result = await agent.get();
+            this.cached = result.visitorId;
+            // Persist to localStorage
+            try {
+                localStorage.setItem(FP_CACHE_KEY, this.cached);
+            }
+            catch {
+                // Silently ignore storage errors
+            }
+            return this.cached;
+        }
+        catch {
+            // Fallback: generate a pseudo-fingerprint from available signals
+            const fallback = this.generateFallbackFingerprint();
+            this.cached = fallback;
+            try {
+                localStorage.setItem(FP_CACHE_KEY, fallback);
+            }
+            catch {
+                // Silently ignore
+            }
+            return fallback;
+        }
+    }
+    /**
+     * Fallback fingerprint when FingerprintJS is unavailable.
+     * Combines basic browser signals into a hash.
+     * @internal
+     */
+    generateFallbackFingerprint() {
+        const signals = [
+            navigator.userAgent,
+            navigator.language,
+            screen.width + 'x' + screen.height,
+            screen.colorDepth?.toString() ?? '',
+            Intl.DateTimeFormat().resolvedOptions().timeZone,
+            navigator.hardwareConcurrency?.toString() ?? '',
+        ].join('|');
+        // Simple string hash (djb2)
+        let hash = 5381;
+        for (let i = 0; i < signals.length; i++) {
+            hash = ((hash << 5) + hash + signals.charCodeAt(i)) >>> 0;
+        }
+        return hash.toString(36).padStart(12, '0');
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiBlackboxFingerprintService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiBlackboxFingerprintService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiBlackboxFingerprintService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * @module ng-ui-system/blackbox
+ * IndexedDB storage adapter for BlackBox sessions.
+ *
+ * Handles persistence, compression (via native CompressionStream gzip),
+ * quota enforcement, and JSONL export.
+ *
+ * Design notes:
+ * - DB name: `ui-blackbox`, object store: `sessions`
+ * - Each session is gzip-compressed before storage for both size
+ *   reduction and inherent obfuscation
+ * - Quota enforced by total stored size; oldest sessions are pruned first
+ */
+const DB_NAME = 'ui-blackbox';
+const DB_VERSION = 1;
+const STORE_NAME = 'sessions';
+/**
+ * Low-level IndexedDB adapter for reading/writing compressed BlackBox sessions.
+ *
+ * @usageNotes
+ * This service is used internally by `UiBlackboxService`.
+ * Consumers should interact with the higher-level `UiBlackboxService` API.
+ */
+class UiBlackboxStorageService {
+    constructor() {
+        this.platformId = inject(PLATFORM_ID);
+        this.db = null;
+        this.maxStorageMb = UI_BLACKBOX_DEFAULTS.maxStorageMb;
+    }
+    // ─── Configuration ─────────────────────────────────────────────────
+    /** Update the storage quota from the parent service config. */
+    setMaxStorageMb(mb) {
+        this.maxStorageMb = mb;
+    }
+    // ─── Database lifecycle ────────────────────────────────────────────
+    /** Open (or create) the IndexedDB database. */
+    async openDb() {
+        if (this.db)
+            return this.db;
+        if (!isPlatformBrowser(this.platformId)) {
+            throw new Error('IndexedDB is not available in SSR');
+        }
+        return new Promise((resolve, reject) => {
+            const request = indexedDB.open(DB_NAME, DB_VERSION);
+            request.onupgradeneeded = () => {
+                const db = request.result;
+                if (!db.objectStoreNames.contains(STORE_NAME)) {
+                    const store = db.createObjectStore(STORE_NAME, { keyPath: 'sessionId' });
+                    store.createIndex('fingerprint', 'fingerprint', { unique: false });
+                    store.createIndex('startedAt', 'startedAt', { unique: false });
+                }
+            };
+            request.onsuccess = () => {
+                this.db = request.result;
+                resolve(this.db);
+            };
+            request.onerror = () => reject(request.error);
+        });
+    }
+    // ─── Compression helpers ───────────────────────────────────────────
+    /** Compress a string to a gzip Uint8Array using native CompressionStream. */
+    async compress(data) {
+        const encoder = new TextEncoder();
+        const stream = new Blob([encoder.encode(data)])
+            .stream()
+            .pipeThrough(new CompressionStream('gzip'));
+        const reader = stream.getReader();
+        const chunks = [];
+        let done = false;
+        while (!done) {
+            const result = await reader.read();
+            done = result.done;
+            if (result.value) {
+                chunks.push(result.value);
+            }
+        }
+        // Merge chunks into a single ArrayBuffer-backed Uint8Array
+        const totalLength = chunks.reduce((sum, c) => sum + c.length, 0);
+        const buffer = new ArrayBuffer(totalLength);
+        const merged = new Uint8Array(buffer);
+        let offset = 0;
+        for (const chunk of chunks) {
+            merged.set(chunk, offset);
+            offset += chunk.length;
+        }
+        return merged;
+    }
+    /** Decompress a gzip Uint8Array back to a string. */
+    async decompress(data) {
+        const stream = new Blob([data])
+            .stream()
+            .pipeThrough(new DecompressionStream('gzip'));
+        const reader = stream.getReader();
+        const decoder = new TextDecoder();
+        let result = '';
+        let done = false;
+        while (!done) {
+            const chunk = await reader.read();
+            done = chunk.done;
+            if (chunk.value) {
+                result += decoder.decode(chunk.value, { stream: !done });
+            }
+        }
+        return result;
+    }
+    // ─── CRUD ──────────────────────────────────────────────────────────
+    /**
+     * Persist a session to IndexedDB (gzip-compressed).
+     * Enforces quota after saving.
+     */
+    async saveSession(session) {
+        const db = await this.openDb();
+        const json = JSON.stringify(session);
+        const compressed = await this.compress(json);
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readwrite');
+            const store = tx.objectStore(STORE_NAME);
+            // Store as { sessionId, fingerprint, startedAt, data: Uint8Array }
+            store.put({
+                sessionId: session.sessionId,
+                fingerprint: session.fingerprint,
+                startedAt: session.startedAt,
+                sizeBytes: compressed.byteLength,
+                data: compressed,
+            });
+            tx.oncomplete = () => {
+                this.enforceQuota().then(resolve).catch(resolve);
+            };
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    /**
+     * Read and decompress a single session by ID.
+     */
+    async getSession(sessionId) {
+        const db = await this.openDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readonly');
+            const store = tx.objectStore(STORE_NAME);
+            const req = store.get(sessionId);
+            req.onsuccess = async () => {
+                if (!req.result) {
+                    resolve(null);
+                    return;
+                }
+                try {
+                    const json = await this.decompress(req.result.data);
+                    resolve(JSON.parse(json));
+                }
+                catch (e) {
+                    reject(e);
+                }
+            };
+            req.onerror = () => reject(req.error);
+        });
+    }
+    /**
+     * Get all stored sessions (decompressed).
+     */
+    async getAllSessions() {
+        const db = await this.openDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readonly');
+            const store = tx.objectStore(STORE_NAME);
+            const req = store.getAll();
+            req.onsuccess = async () => {
+                try {
+                    const sessions = [];
+                    for (const record of req.result) {
+                        const json = await this.decompress(record.data);
+                        sessions.push(JSON.parse(json));
+                    }
+                    resolve(sessions);
+                }
+                catch (e) {
+                    reject(e);
+                }
+            };
+            req.onerror = () => reject(req.error);
+        });
+    }
+    /**
+     * Get all sessions for a given fingerprint.
+     */
+    async getSessionsByFingerprint(fingerprint) {
+        const db = await this.openDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readonly');
+            const store = tx.objectStore(STORE_NAME);
+            const index = store.index('fingerprint');
+            const req = index.getAll(fingerprint);
+            req.onsuccess = async () => {
+                try {
+                    const sessions = [];
+                    for (const record of req.result) {
+                        const json = await this.decompress(record.data);
+                        sessions.push(JSON.parse(json));
+                    }
+                    resolve(sessions);
+                }
+                catch (e) {
+                    reject(e);
+                }
+            };
+            req.onerror = () => reject(req.error);
+        });
+    }
+    /**
+     * Generate a downloadable JSONL Blob of all sessions.
+     * Each line is one JSON-serialised session (decompressed).
+     */
+    async exportDump() {
+        const sessions = await this.getAllSessions();
+        const lines = sessions.map((s) => JSON.stringify(s)).join('\n');
+        return new Blob([lines], { type: 'application/x-ndjson' });
+    }
+    /**
+     * Delete all stored sessions.
+     */
+    async clearAll() {
+        const db = await this.openDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readwrite');
+            const store = tx.objectStore(STORE_NAME);
+            store.clear();
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    // ─── Quota enforcement ─────────────────────────────────────────────
+    /**
+     * Prune oldest sessions until total stored size is under `maxStorageMb`.
+     * @internal
+     */
+    async enforceQuota() {
+        const db = await this.openDb();
+        const maxBytes = this.maxStorageMb * 1024 * 1024;
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readwrite');
+            const store = tx.objectStore(STORE_NAME);
+            const index = store.index('startedAt');
+            // Collect all records sorted by startedAt (ascending = oldest first)
+            const cursorReq = index.openCursor();
+            const records = [];
+            let totalSize = 0;
+            cursorReq.onsuccess = () => {
+                const cursor = cursorReq.result;
+                if (cursor) {
+                    const size = cursor.value.sizeBytes || 0;
+                    totalSize += size;
+                    records.push({ key: cursor.primaryKey, size });
+                    cursor.continue();
+                }
+                else {
+                    // Cursor exhausted — prune if over quota
+                    if (totalSize <= maxBytes) {
+                        resolve();
+                        return;
+                    }
+                    let freed = 0;
+                    const target = totalSize - maxBytes;
+                    for (const record of records) {
+                        if (freed >= target)
+                            break;
+                        store.delete(record.key);
+                        freed += record.size;
+                    }
+                    resolve();
+                }
+            };
+            cursorReq.onerror = () => reject(cursorReq.error);
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiBlackboxStorageService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiBlackboxStorageService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiBlackboxStorageService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * @module ng-ui-system/blackbox
+ * Core BlackBox observability service — the main entry point for session
+ * recording, event buffering, and export.
+ *
+ * Architecture:
+ * - Root singleton (`providedIn: 'root'`)
+ * - On first inject: generates fingerprint, creates session, subscribes to Router events
+ * - Centralised in-memory buffer with periodic/threshold-based flush to IndexedDB
+ * - `window:beforeunload` triggers a final best-effort async flush
+ */
+/**
+ * Central BlackBox observability service.
+ *
+ * Records navigation, UI interactions, form events, and HTTP calls
+ * into compressed sessions stored in IndexedDB.
+ *
+ * @usageNotes
+ * The service activates automatically when injected. Provide it at root level
+ * and it will start recording immediately.
+ *
+ * ```typescript
+ * // app.config.ts — just importing the service is enough
+ * import { UiBlackboxService } from '@gnggln/ng-ui-system';
+ *
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [
+ *     // The service is providedIn: 'root', so it's auto-provided.
+ *     // To force eager initialisation:
+ *     { provide: APP_INITIALIZER, useFactory: () => () => inject(UiBlackboxService), multi: true },
+ *   ],
+ * };
+ * ```
+ */
+class UiBlackboxService {
+    constructor() {
+        this.platformId = inject(PLATFORM_ID);
+        this.router = inject(Router);
+        this.zone = inject(NgZone);
+        this.fingerprint = inject(UiBlackboxFingerprintService);
+        this.storage = inject(UiBlackboxStorageService);
+        this.destroy$ = new Subject();
+        this.config = { ...UI_BLACKBOX_DEFAULTS };
+        this.currentStep = null;
+        this.initialised = false;
+        // ─── Centralised event buffer ──────────────────────────────────────
+        this.buffer = [];
+        this.flushTimerId = null;
+        this.beforeUnloadHandler = null;
+        if (isPlatformBrowser(this.platformId)) {
+            this.init();
+        }
+    }
+    // ─── Initialisation ────────────────────────────────────────────────
+    async init() {
+        // Generate session ID
+        const sessionId = this.generateUuid();
+        const fp = await this.fingerprint.getFingerprint();
+        this.session = {
+            sessionId,
+            fingerprint: fp,
+            startedAt: Date.now(),
+            userAgent: navigator.userAgent,
+            steps: [],
+            formEvents: [],
+            calls: [],
+        };
+        // Create initial step from current URL
+        this.currentStep = {
+            timestamp: Date.now(),
+            route: this.router.url,
+            actions: [],
+        };
+        this.session.steps.push(this.currentStep);
+        // Subscribe to router navigation
+        this.router.events
+            .pipe(filter((e) => e instanceof NavigationEnd), takeUntil(this.destroy$))
+            .subscribe((event) => {
+            const previousRoute = this.currentStep?.route;
+            this.currentStep = {
+                timestamp: Date.now(),
+                route: event.urlAfterRedirects,
+                previousRoute,
+                actions: [],
+            };
+            this.pushBufferEvent({ kind: 'step', payload: this.currentStep });
+        });
+        // Setup periodic flush (outside Angular zone to avoid triggering CD)
+        this.zone.runOutsideAngular(() => {
+            this.flushTimerId = setInterval(() => this.flush(), this.config.flushIntervalMs);
+            // Best-effort flush on tab close (IndexedDB is async, no sync fallback)
+            this.beforeUnloadHandler = () => {
+                this.session.endedAt = Date.now();
+                void this.flush();
+            };
+            window.addEventListener('beforeunload', this.beforeUnloadHandler);
+        });
+        this.initialised = true;
+    }
+    // ─── Public API: Configuration ─────────────────────────────────────
+    /**
+     * Update the BlackBox configuration.
+     * Can be called at any time; changes take effect immediately.
+     */
+    configure(config) {
+        this.config = {
+            ...this.config,
+            ...config,
+            formTracking: {
+                ...this.config.formTracking,
+                ...(config.formTracking ?? {}),
+            },
+        };
+        this.storage.setMaxStorageMb(this.config.maxStorageMb);
+        // Restart flush timer with new interval
+        if (this.flushTimerId !== null) {
+            clearInterval(this.flushTimerId);
+            this.zone.runOutsideAngular(() => {
+                this.flushTimerId = setInterval(() => this.flush(), this.config.flushIntervalMs);
+            });
+        }
+    }
+    /** Returns the current configuration (readonly snapshot). */
+    getConfig() {
+        return { ...this.config };
+    }
+    // ─── Public API: Tracking ──────────────────────────────────────────
+    /**
+     * Manually track a UI action (click).
+     *
+     * Called automatically by `UiButtonAreaComponent` and the `[uiTrack]` directive.
+     * Can also be called programmatically for custom interactions.
+     *
+     * @param trackId - Identifier for the action (e.g. button id, link name).
+     * @param meta - Optional metadata: `tag`, `text`, `id` of the element.
+     */
+    trackAction(trackId, meta) {
+        if (!this.initialised)
+            return;
+        const action = {
+            timestamp: Date.now(),
+            type: 'click',
+            target: {
+                tag: meta?.tag ?? 'unknown',
+                id: meta?.id,
+                trackId,
+                text: meta?.text?.substring(0, 50),
+            },
+        };
+        // Add to current step immediately (for in-memory session access)
+        this.currentStep?.actions.push(action);
+        // Also push to buffer for persistence
+        this.pushBufferEvent({
+            kind: 'action',
+            payload: { ...action, route: this.currentStep?.route ?? this.router.url },
+        });
+    }
+    /**
+     * Track a form interaction event.
+     *
+     * Called automatically by `UiFormBuilderComponent` when the BlackBox
+     * service is available.
+     */
+    trackFormEvent(event) {
+        if (!this.initialised)
+            return;
+        this.session.formEvents.push(event);
+        this.pushBufferEvent({ kind: 'formEvent', payload: event });
+    }
+    /**
+     * Track an intercepted HTTP call.
+     * Called by `UiBlackboxInterceptor`.
+     * @internal
+     */
+    trackHttpCall(call) {
+        if (!this.initialised)
+            return;
+        this.session.calls.push(call);
+        this.pushBufferEvent({ kind: 'httpCall', payload: call });
+    }
+    // ─── Public API: Session access ────────────────────────────────────
+    /**
+     * Returns the current in-memory session (live, not yet flushed).
+     * Useful for debugging or real-time inspection.
+     */
+    getCurrentSession() {
+        return this.session;
+    }
+    /**
+     * Retrieve all sessions stored in IndexedDB (decompressed).
+     */
+    async getSessionHistory() {
+        return this.storage.getAllSessions();
+    }
+    /**
+     * Retrieve sessions for the current device fingerprint.
+     */
+    async getSessionsForDevice() {
+        const fp = await this.fingerprint.getFingerprint();
+        return this.storage.getSessionsByFingerprint(fp);
+    }
+    // ─── Public API: Export ────────────────────────────────────────────
+    /**
+     * Export all sessions as a downloadable JSONL Blob.
+     *
+     * @returns A Blob containing JSONL data (one session per line).
+     *
+     * @example
+     * ```typescript
+     * const blob = await blackbox.exportSessions();
+     * const url = URL.createObjectURL(blob);
+     * const a = document.createElement('a');
+     * a.href = url;
+     * a.download = 'blackbox-sessions.jsonl';
+     * a.click();
+     * ```
+     */
+    async exportSessions() {
+        // Flush current session first
+        await this.flush();
+        return this.storage.exportDump();
+    }
+    // ─── Public API: Lifecycle ─────────────────────────────────────────
+    /**
+     * Explicitly end the current session.
+     * Flushes all buffered events and marks the session as ended.
+     */
+    async endSession() {
+        if (!this.initialised)
+            return;
+        this.session.endedAt = Date.now();
+        await this.flush();
+    }
+    /**
+     * Clear all stored sessions from IndexedDB.
+     */
+    async clearHistory() {
+        return this.storage.clearAll();
+    }
+    // ─── Buffer management ─────────────────────────────────────────────
+    /**
+     * Push an event into the centralised buffer.
+     * Triggers an immediate flush if the buffer exceeds the threshold.
+     * @internal
+     */
+    pushBufferEvent(event) {
+        this.buffer.push(event);
+        if (this.buffer.length >= this.config.flushThreshold) {
+            this.flush();
+        }
+    }
+    /**
+     * Flush buffered events to IndexedDB asynchronously.
+     * @internal
+     */
+    async flush() {
+        if (!this.initialised || this.buffer.length === 0)
+            return;
+        // Drain buffer
+        const events = this.buffer.splice(0);
+        // Apply step events to the session
+        for (const event of events) {
+            if (event.kind === 'step') {
+                // Steps are already pushed in real-time; ensure they're in the session
+                if (!this.session.steps.includes(event.payload)) {
+                    this.session.steps.push(event.payload);
+                }
+            }
+            // Actions, formEvents, httpCalls are already pushed in real-time
+            // to the in-memory session by trackAction/trackFormEvent/trackHttpCall
+        }
+        // Save the full session snapshot
+        try {
+            await this.storage.saveSession(this.session);
+        }
+        catch (e) {
+            // storage error — re-enqueue events for next flush
+            console.warn('[UiBlackbox] Storage flush failed:', e);
+        }
+    }
+    // ─── Utilities ─────────────────────────────────────────────────────
+    /** Generate a UUID v4. */
+    generateUuid() {
+        if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+            return crypto.randomUUID();
+        }
+        // Fallback for older browsers
+        return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+            const r = (Math.random() * 16) | 0;
+            const v = c === 'x' ? r : (r & 0x3) | 0x8;
+            return v.toString(16);
+        });
+    }
+    // ─── Cleanup ───────────────────────────────────────────────────────
+    ngOnDestroy() {
+        this.destroy$.next();
+        this.destroy$.complete();
+        if (this.flushTimerId !== null) {
+            clearInterval(this.flushTimerId);
+        }
+        if (this.beforeUnloadHandler) {
+            window.removeEventListener('beforeunload', this.beforeUnloadHandler);
+        }
+        // Final flush
+        void this.flush();
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiBlackboxService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiBlackboxService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiBlackboxService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [] });
+
+/**
+ * @module ng-ui-system/http
+ * Central HTTP orchestration service.
+ *
+ * Wraps Angular's `HttpClient` with an automatic pipeline:
+ * - Loader activation via `UiLayoutService`
+ * - Success / error toasts via `UiToastService`
+ * - Debounced toast messages to prevent spam
+ * - Optional BlackBox tracking of every call
+ * - Pluggable custom headers via `UiHeadersProvider`
+ *
+ * @usageNotes
+ * ### Basic GET
+ * ```typescript
+ * const http = inject(UiHttpService);
+ * const endpoint: UiEndpoint = {
+ *   url: '/api/users',
+ *   id: 'users_list',
+ * };
+ * http.get<User[]>(endpoint).subscribe(users => { ... });
+ * ```
+ *
+ * ### POST with success toast
+ * ```typescript
+ * const endpoint: UiEndpoint = {
+ *   url: '/api/users',
+ *   id: 'users_create',
+ *   showSuccess: true,
+ *   messages: { success: 'Utente creato!' },
+ * };
+ * http.post<User>(endpoint, payload).subscribe();
+ * ```
+ *
+ * ### Custom headers provider
+ * ```typescript
+ * // app.config.ts
+ * { provide: UI_HEADERS_PROVIDER, useClass: MyAuthHeaders }
+ * ```
+ */
+/**
+ * Central HTTP service with automatic loader, toast, and error handling.
+ *
+ * All toast flags default to `false` — enable them per-endpoint via
+ * `showSuccess: true` and/or `showError: true`.
+ */
+class UiHttpService {
+    constructor() {
+        this.http = inject(HttpClient);
+        this.messageHandler = inject(UiHttpMessageHandler);
+        this.config = inject(UI_HTTP_CONFIG, { optional: true });
+        this.headersProvider = inject(UI_HEADERS_PROVIDER, { optional: true });
+        this.blackbox = inject(UiBlackboxService, { optional: true });
+    }
+    /** Resolved base URL from config token. */
+    get baseUrl() {
+        return this.config?.baseUrl ?? '';
+    }
+    // ── HTTP Methods ───────────────────────────────────────────────────
+    /** Execute a **GET** request. */
+    get(endpoint, options = {}) {
+        return this._request('GET', endpoint, null, options);
+    }
+    /** Execute a **POST** request. */
+    post(endpoint, body, options = {}) {
+        return this._request('POST', endpoint, body, options);
+    }
+    /** Execute a **PUT** request. */
+    put(endpoint, body, options = {}) {
+        return this._request('PUT', endpoint, body, options);
+    }
+    /** Execute a **PATCH** request. */
+    patch(endpoint, body, options = {}) {
+        return this._request('PATCH', endpoint, body, options);
+    }
+    /** Execute a **DELETE** request. */
+    delete(endpoint, body, options = {}) {
+        return this._request('DELETE', endpoint, body ?? null, options);
+    }
+    /**
+     * Download a **binary file** (Blob).
+     *
+     * Applies the same loader / toast pipeline as JSON requests.
+     */
+    download(endpoint, options = {}) {
+        const headers = this.buildHeaders(options.headers);
+        const requestOptions = {
+            headers,
+            params: options.params,
+            observe: 'body',
+            responseType: 'blob',
+        };
+        const url = this.baseUrl + endpoint.url;
+        const startTime = Date.now();
+        const observable = this.http.get(url, requestOptions);
+        return this._handleRequest(observable, endpoint, 'GET', url, startTime);
+    }
+    // ── Manual controls ────────────────────────────────────────────────
+    /** Show a custom success toast (not tied to an endpoint). */
+    showCustomSuccess(message) {
+        this.messageHandler.showCustomSuccess(message);
+    }
+    /** Show a custom error toast (not tied to an endpoint). */
+    showCustomError(message) {
+        this.messageHandler.showCustomError(message);
+    }
+    /** Manually control the loader state. */
+    setLoading(loading) {
+        if (loading) {
+            this.messageHandler.startLoading();
+        }
+        else {
+            this.messageHandler.stopLoading();
+        }
+    }
+    /** Show a success toast for a specific endpoint (manual trigger). */
+    showEndpointSuccess(endpoint) {
+        this.messageHandler.showSuccess(endpoint);
+    }
+    /** Show an error toast for a specific endpoint (manual trigger). */
+    showEndpointError(endpoint, error, fallbackMessage) {
+        this.messageHandler.showError(endpoint, error, fallbackMessage);
+    }
+    /** Cancel all pending debounce timeouts. */
+    clearAllToastTimeouts() {
+        this.messageHandler.clearAllTimeouts();
+    }
+    // ── Internals ──────────────────────────────────────────────────────
+    /**
+     * Generic JSON request handler.
+     * Builds headers, serialises body, and pipes through the common pipeline.
+     */
+    _request(method, endpoint, body, options) {
+        const headers = this.buildHeaders(options.headers);
+        const url = this.baseUrl + endpoint.url;
+        const startTime = Date.now();
+        const requestOptions = {
+            headers,
+            params: options.params,
+            body: body != null ? JSON.stringify(body) : undefined,
+            observe: 'body',
+        };
+        const observable = this.http.request(method, url, requestOptions);
+        return this._handleRequest(observable, endpoint, method, url, startTime);
+    }
+    /**
+     * Common pipeline applied to every HTTP request:
+     * 1. Start loader
+     * 2. On success → show success toast
+     * 3. On error → show error toast, log, re-throw
+     * 4. Always stop loader
+     * 5. Track in BlackBox (if available and endpoint is trackable)
+     */
+    _handleRequest(observable, endpoint, method, url, startTime) {
+        this.messageHandler.startLoading();
+        return observable.pipe(map((response) => {
+            this.messageHandler.showSuccess(endpoint);
+            this.trackBlackbox(method, url, startTime, 200, endpoint);
+            return response;
+        }), catchError((error) => {
+            this.handleErrors(error, endpoint);
+            this.trackBlackbox(method, url, startTime, error.status ?? 0, endpoint);
+            return throwError(() => error);
+        }), finalize(() => this.messageHandler.stopLoading()));
+    }
+    /**
+     * Build the final HttpHeaders by merging:
+     * 1. Default headers from config
+     * 2. Custom headers from UiHeadersProvider
+     * 3. Per-request headers
+     */
+    buildHeaders(requestHeaders) {
+        const defaults = {
+            'Content-Type': 'application/json; charset=utf-8',
+            ...(this.config?.defaultHeaders ?? {}),
+        };
+        // Apply custom headers from provider
+        const custom = this.headersProvider?.getHeaders() ?? {};
+        let headers = new HttpHeaders({ ...defaults, ...custom });
+        // Merge per-request headers
+        if (requestHeaders) {
+            requestHeaders.keys().forEach(key => {
+                const value = requestHeaders.get(key);
+                if (value !== null) {
+                    headers = headers.set(key, value);
+                }
+            });
+        }
+        return headers;
+    }
+    /**
+     * Centralised error handling.
+     * Logs the error and delegates toast display to the message handler.
+     */
+    handleErrors(error, endpoint) {
+        console.error(`[UiHttpService] API Error (${error.status}):`, error.url, error);
+        this.messageHandler.showError(endpoint, error, 'Si è verificato un errore imprevisto');
+    }
+    /**
+     * Track the HTTP call in BlackBox if the service is available
+     * and the endpoint hasn't opted out.
+     */
+    trackBlackbox(method, url, startTime, status, endpoint) {
+        if (!this.blackbox || endpoint.trackable === false)
+            return;
+        this.blackbox.trackHttpCall({
+            timestamp: startTime,
+            method,
+            url,
+            status,
+            durationMs: Date.now() - startTime,
+        });
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiHttpService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiHttpService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: UiHttpService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * ng-ui-system — HTTP Orchestration Service entry point.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   UiHttpService,
+ *   UiHttpMessageHandler,
+ *   UI_HTTP_CONFIG,
+ *   UI_HEADERS_PROVIDER,
+ * } from '@gnggln/ng-ui-system';
+ * ```
+ */
+// Services
+
+/**
+ * Bootstrap del secondary entry `@gnggln/ng-ui-system/http`. Servizio HTTP e tipi endpoint.
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { UI_HEADERS_PROVIDER, UI_HTTP_CONFIG, UiHttpMessageHandler, UiHttpService };
+//# sourceMappingURL=gnggln-ng-ui-system-http.mjs.map