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

package/base-layout/lib/components/page-header/breadcrumb.service.d.ts

@@ -0,0 +1,96 @@
+import { type ActivatedRoute } from '@angular/router';
+import { type UiBreadcrumbItem } from './page-header.types';
+import * as i0 from "@angular/core";
+/**
+ * Service that builds a nested breadcrumb trail from Angular route configuration.
+ *
+ * Routes must define `data.id`, `data.title`, and optionally `data.breadcrumbs`
+ * (an array of parent route IDs) for the chain to resolve correctly.
+ *
+ * Supports lazy-loaded routes: the internal route map is rebuilt automatically
+ * whenever new routes are loaded via `NavigationEnd`.
+ *
+ * Label resolution for route parameters (`:param`) is delegated to an injectable
+ * `UiLabelResolverFn` via the `UI_BREADCRUMB_LABEL_RESOLVER` token.
+ *
+ * @usageNotes
+ * ### Route configuration
+ * ```typescript
+ * const routes: Routes = [
+ *   {
+ *     path: 'users',
+ *     data: { id: 'users', title: 'Utenti' },
+ *     children: [
+ *       {
+ *         path: ':userId',
+ *         data: { id: 'user-detail', title: ':userId', breadcrumbs: ['users'] },
+ *         component: UserDetailComponent,
+ *       },
+ *     ],
+ *   },
+ * ];
+ * ```
+ *
+ * ### Custom label resolver
+ * ```typescript
+ * providers: [
+ *   {
+ *     provide: UI_BREADCRUMB_LABEL_RESOLVER,
+ *     useValue: (name: string, value: string) =>
+ *       name === 'userId' ? `User #${value}` : value,
+ *   },
+ * ]
+ * ```
+ */
+export declare class UiBreadcrumbService {
+    private readonly router;
+    private readonly labelResolver;
+    /** @internal Map of route ID → breadcrumb configuration. */
+    private breadcrumbMap;
+    /** @internal Tracks route count to detect lazy-loaded route additions. */
+    private lastRouteConfigLength;
+    /** @internal Last computed breadcrumbs for navigateBack. */
+    private lastBreadcrumbs;
+    constructor();
+    /**
+     * Computes the breadcrumb trail for the currently active route.
+     *
+     * @param route - The root `ActivatedRoute` (typically injected in the component).
+     * @returns Ordered array of breadcrumb items from root to current route.
+     */
+    getBreadcrumbsForRoute(route: ActivatedRoute): UiBreadcrumbItem[];
+    /**
+     * Navigates to the previous breadcrumb (parent route).
+     * Falls back to `fallbackUrl` (default: `/`) when no parent exists.
+     */
+    navigateBack(fallbackUrl?: string): void;
+    /** @internal Collects all route params from the full path (including parents). */
+    private collectParamsFromPath;
+    /** @internal Rebuilds the map only when new lazy routes appear. */
+    private rebuildRouteMapIfNeeded;
+    /** @internal Recursively counts routes including lazy-loaded children. */
+    private countRoutes;
+    /** @internal Clears and rebuilds the full route → breadcrumb map. */
+    private rebuildRouteMap;
+    /** @internal Recursively walks route tree to build the breadcrumb map. */
+    private buildRouteMap;
+    /** @internal Builds the full breadcrumb chain for a route by its ID. */
+    private buildBreadcrumbChain;
+    /** @internal Resolves parent breadcrumbs from ordered parent IDs. */
+    private getParentChain;
+    /**
+     * @internal Resolves `:param` placeholders in a label using
+     * the injected label resolver function.
+     */
+    private resolveLabel;
+    /** @internal Resolves `:param` placeholders in a path and creates a URL. */
+    private resolveUrl;
+    /** @internal Normalizes path by collapsing double slashes and trimming trailing slash. */
+    private normalizePath;
+    /** @internal Removes query parameters from a URL. */
+    private stripQueryParams;
+    /** @internal Caches the fully resolved URL for a route ID. */
+    private saveFullPath;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiBreadcrumbService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UiBreadcrumbService>;
+}

package/base-layout/lib/components/page-header/page-header.component.d.ts

@@ -0,0 +1,59 @@
+import { OnInit } from '@angular/core';
+import { UiBreadcrumbItem } from './page-header.types';
+import * as i0 from "@angular/core";
+/**
+ * Page header component that renders a breadcrumb navigation trail
+ * and a page title. Integrates with `UiBreadcrumbService` to
+ * automatically derive breadcrumbs from Angular route configuration.
+ *
+ * The breadcrumb trail is generated from route `data` properties:
+ * - `data.id` — unique route identifier
+ * - `data.title` — display label
+ * - `data.breadcrumbs` — ordered array of parent route IDs
+ *
+ * @selector ui-page-header
+ *
+ * @example
+ * ```html
+ * <!-- Auto breadcrumbs from route data -->
+ * <ui-page-header />
+ *
+ * <!-- With explicit title override -->
+ * <ui-page-header title="Custom Title" />
+ *
+ * <!-- With document title update -->
+ * <ui-page-header [updateDocumentTitle]="true" titleSuffix=" | My App" />
+ * ```
+ */
+export declare class UiPageHeaderComponent implements OnInit {
+    /** Override the auto-detected page title. When empty, title is derived from the last breadcrumb. */
+    title: string;
+    /** Route path for the Home breadcrumb link. */
+    homeRoute: string;
+    /** Whether to display the Home link at the start of the trail. */
+    showHome: boolean;
+    /** When `true`, updates `document.title` on each navigation. */
+    updateDocumentTitle: boolean;
+    /** Suffix appended to `document.title` (e.g. `' | My App'`). Only used when `updateDocumentTitle` is `true`. */
+    titleSuffix: string;
+    /** @internal */
+    breadcrumbs: UiBreadcrumbItem[];
+    private readonly router;
+    private readonly activatedRoute;
+    private readonly titleService;
+    private readonly breadcrumbService;
+    private readonly destroyRef;
+    private readonly cdr;
+    /** Resolved page title: explicit `title` input wins, otherwise last breadcrumb label. */
+    get displayTitle(): string;
+    ngOnInit(): void;
+    /**
+     * Navigates to the previous breadcrumb (parent route).
+     * @param fallbackUrl - URL to navigate to when no parent exists (default: homeRoute).
+     */
+    navigateBack(fallbackUrl?: string): void;
+    /** @internal */
+    private refresh;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiPageHeaderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiPageHeaderComponent, "ui-page-header", never, { "title": { "alias": "title"; "required": false; }; "homeRoute": { "alias": "homeRoute"; "required": false; }; "showHome": { "alias": "showHome"; "required": false; }; "updateDocumentTitle": { "alias": "updateDocumentTitle"; "required": false; }; "titleSuffix": { "alias": "titleSuffix"; "required": false; }; }, {}, never, never, true, never>;
+}

package/base-layout/lib/components/page-header/page-header.types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @module ng-ui-system/page-header
+ * Types and interfaces for UiPageHeader and UiBreadcrumbService.
+ */
+import { InjectionToken } from '@angular/core';
+/**
+ * Single breadcrumb item rendered in the navigation trail.
+ *
+ * @usageNotes
+ * ### Structure
+ * ```typescript
+ * const item: UiBreadcrumbItem = {
+ *   label: 'Dashboard',
+ *   url: '/dashboard',
+ *   isLast: false,
+ * };
+ * ```
+ */
+export interface UiBreadcrumbItem {
+    /** Display text for the breadcrumb link. */
+    label: string;
+    /** Navigation URL (Angular Router path). */
+    url: string;
+    /** Whether this is the last (current) breadcrumb in the trail. */
+    isLast: boolean;
+}
+/**
+ * Internal route configuration stored by UiBreadcrumbService.
+ * Built from Angular route `data` properties.
+ *
+ * @usageNotes
+ * ### Route data convention
+ * ```typescript
+ * {
+ *   path: 'users/:userId',
+ *   data: {
+ *     id: 'user-detail',
+ *     title: 'Dettaglio utente',
+ *     breadcrumbs: ['users-list'],
+ *   },
+ *   component: UserDetailComponent,
+ * }
+ * ```
+ */
+export interface UiBreadcrumbConfig {
+    /** Unique route identifier (from `route.data.id`). */
+    id: string;
+    /** Resolved route path pattern (may contain `:param` placeholders). */
+    path: string;
+    /** Display label (from `route.data.title` or fallback). */
+    label: string;
+    /** Ordered array of parent route IDs for building the breadcrumb chain. */
+    parentIds: string[];
+    /** Fully resolved URL captured at navigation time. */
+    fullPath?: string;
+    /** Raw route data metadata. */
+    metadata?: Record<string, any>;
+}
+/**
+ * Function signature for resolving route parameter values to human-readable labels.
+ *
+ * Consumers can provide a custom implementation via `UI_BREADCRUMB_LABEL_RESOLVER`
+ * to translate cryptic parameter values (e.g. UUIDs, slugs) into user-friendly text.
+ *
+ * @param paramName - The route parameter name (e.g. `'userId'`).
+ * @param paramValue - The raw parameter value from the URL (e.g. `'abc-123'`).
+ * @returns A human-readable label, or the original value if no mapping exists.
+ *
+ * @usageNotes
+ * ### Custom resolver
+ * ```typescript
+ * const myResolver: UiLabelResolverFn = (name, value) => {
+ *   if (name === 'status') {
+ *     return { pending: 'In attesa', active: 'Attivo' }[value] ?? value;
+ *   }
+ *   return value;
+ * };
+ *
+ * providers: [
+ *   { provide: UI_BREADCRUMB_LABEL_RESOLVER, useValue: myResolver },
+ * ]
+ * ```
+ */
+export type UiLabelResolverFn = (paramName: string, paramValue: string) => string;
+/**
+ * Injection token for providing a custom label resolver to UiBreadcrumbService.
+ *
+ * When not provided, parameters are displayed as-is (identity function).
+ *
+ * @example
+ * ```typescript
+ * // In your app.config.ts or module providers:
+ * { provide: UI_BREADCRUMB_LABEL_RESOLVER, useValue: myLabelResolver }
+ * ```
+ */
+export declare const UI_BREADCRUMB_LABEL_RESOLVER: InjectionToken<UiLabelResolverFn>;

package/base-layout/lib/core/types/index.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Shared types for ng-ui-system components.
+ * These types are used across multiple components to ensure consistency.
+ */
+/** Standard size variants used across components. */
+export type UiSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/** Visual style variants for components. */
+export type UiVariant = 'primary' | 'accent' | 'warn' | 'neutral' | 'ghost' | 'outline';
+/** Semantic color palette tokens. */
+export type UiColor = 'primary' | 'accent' | 'warn' | 'success' | 'info' | 'neutral';
+/** Layout direction. */
+export type UiDirection = 'horizontal' | 'vertical';
+/** Horizontal alignment. */
+export type UiAlign = 'start' | 'center' | 'end' | 'stretch';
+/** Component density options for compact or spacious layouts. */
+export type UiDensity = 'compact' | 'default' | 'comfortable';
+/**
+ * Common Lucide icon names with autocomplete support.
+ * Accepts any valid Lucide icon name as a string.
+ *
+ * Provides IntelliSense for the most frequently used enterprise icons.
+ * For the full icon catalogue, visit https://lucide.dev/icons
+ *
+ * @example
+ * ```typescript
+ * const myIcon: UiIconName = 'arrow-right';  // autocomplete ✓
+ * const custom: UiIconName = 'my-custom-icon'; // still valid
+ * ```
+ */
+export type UiIconName = 'arrow-right' | 'arrow-left' | 'arrow-up' | 'arrow-down' | 'chevron-right' | 'chevron-left' | 'chevron-up' | 'chevron-down' | 'external-link' | 'corner-down-left' | 'corner-down-right' | 'check' | 'x' | 'plus' | 'minus' | 'search' | 'refresh-cw' | 'download' | 'upload' | 'save' | 'trash-2' | 'pencil' | 'copy' | 'clipboard' | 'share-2' | 'send' | 'log-in' | 'log-out' | 'mail' | 'message-circle' | 'phone' | 'bell' | 'user' | 'users' | 'lock' | 'unlock' | 'key' | 'shield' | 'file' | 'file-text' | 'file-spreadsheet' | 'file-archive' | 'folder' | 'image' | 'camera' | 'paperclip' | 'info' | 'alert-triangle' | 'alert-circle' | 'check-circle' | 'x-circle' | 'help-circle' | 'loader-2' | 'menu' | 'more-horizontal' | 'more-vertical' | 'grid' | 'list' | 'filter' | 'sliders' | 'columns' | 'maximize-2' | 'minimize-2' | 'home' | 'settings' | 'star' | 'heart' | 'bookmark' | 'calendar' | 'clock' | 'map-pin' | 'eye' | 'eye-off' | 'sun' | 'moon' | 'monitor' | (string & Record<never, never>);
+/** Status values used for feedback components (badges, alerts, indicators). */
+export type UiStatus = 'idle' | 'loading' | 'success' | 'error' | 'warning' | 'info';
+/**
+ * Generic key-value pair used in select options, dropdowns, etc.
+ * @template T - The type of the value.
+ */
+export interface UiOption<T = string> {
+    /** The display label. */
+    label: string;
+    /** The underlying value. */
+    value: T;
+    /** Whether this option is disabled. */
+    disabled?: boolean;
+    /** Optional icon name (Lucide icon). */
+    icon?: UiIconName;
+    /** Optional grouping key for grouped selects. */
+    group?: string;
+}
+/**
+ * Result wrapper for async operations.
+ * @template T - The type of the data payload.
+ */
+export interface UiAsyncState<T = unknown> {
+    status: UiStatus;
+    data: T | null;
+    error: string | null;
+}
+/** Toast notification type. */
+export type UiToastType = 'success' | 'error' | 'warning' | 'info';
+/** Messages configuration for an endpoint (inline, no label archive). */
+export interface UiEndpointMessages {
+    /** Success toast message. Supports `${key}` placeholders replaced at runtime. */
+    success?: string;
+    /** Error toast message. Supports `${key}` placeholders replaced at runtime. */
+    error?: string;
+}
+/**
+ * Extracts a custom error message from the HTTP error response.
+ * Return `null` to fall back to the default message.
+ */
+export type UiErrorExtractor = (error: any) => string | null;
+/**
+ * Dynamically resolves a success message at runtime.
+ * Return `null` to fall back to the default message.
+ */
+export type UiSuccessResolver = () => string | null;
+/**
+ * Query parameters for URL building.
+ * Keys map to query param names; values are auto-converted to strings.
+ */
+export type UiQueryParameters = Record<string, string | string[] | number | number[] | boolean>;
+/**
+ * Endpoint configuration for `UiHttpService`.
+ *
+ * Each endpoint defines its URL, optional inline messages, and
+ * toast/error behaviour. All toast flags default to `false` (opt-in).
+ *
+ * @usageNotes
+ * ### Basic endpoint factory
+ * ```typescript
+ * const SAVE_USER = (): UiEndpoint => ({
+ *   url: '/api/users',
+ *   id: 'user_save',
+ *   showSuccess: true,
+ *   messages: { success: 'Utente salvato!' },
+ * });
+ * ```
+ *
+ * ### Dynamic endpoint with replacements
+ * ```typescript
+ * const UPDATE_ITEM = (id: number): UiEndpoint => ({
+ *   url: `/api/items/${id}`,
+ *   id: 'item_update',
+ *   showSuccess: true,
+ *   showError: true,
+ *   messages: {
+ *     success: 'Elemento ${name} aggiornato',
+ *     error: 'Errore aggiornamento elemento',
+ *   },
+ *   replacements: { name: 'Widget' },
+ * });
+ * ```
+ */
+export interface UiEndpoint {
+    /** Relative or absolute URL for the API call. */
+    url: string;
+    /** Unique identifier for the endpoint (used for debounce keying). */
+    id: string;
+    /** Whether to show a success toast on completion. Default: `false`. */
+    showSuccess?: boolean;
+    /** Whether to show an error toast on failure. Default: `false`. */
+    showError?: boolean;
+    /** Inline messages for success/error toasts. */
+    messages?: UiEndpointMessages;
+    /** Placeholder replacements for message strings (`${key}` → value). */
+    replacements?: Record<string, string | number>;
+    /** Custom error message extractor from the HTTP error response. */
+    errorExtractor?: UiErrorExtractor;
+    /** Custom success message resolver (overrides inline message). */
+    successMessageResolver?: UiSuccessResolver;
+    /** Whether this endpoint should be tracked by BlackBox. Default: `true`. */
+    trackable?: boolean;
+}

package/blackbox/entry-blackbox.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Bootstrap del secondary entry `@gnggln/ng-ui-system/blackbox`. BlackBox observability.
+ */
+export * from './lib/components/blackbox/index';

package/blackbox/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generated bundle index. Do not edit.
+ */
+/// <amd-module name="@gnggln/ng-ui-system/blackbox" />
+export * from './entry-blackbox';

package/blackbox/lib/components/blackbox/blackbox-debugger.component.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @module ng-ui-system/blackbox
+ * Componente debugger BlackBox — aperto in modale fullscreen.
+ *
+ * Layout:
+ * - Header con titolo e chiusura
+ * - Tab group: Dashboard | Timeline | Form Events | HTTP Calls
+ *
+ * Funzionalita:
+ * - Timeline unificata (navigazioni + click + form events + HTTP calls)
+ * - Form events con valori del form visibili
+ * - JSON detail modal al click su dati strutturati
+ */
+import { OnInit, OnDestroy } from '@angular/core';
+import { MatDialogRef } from '@angular/material/dialog';
+import { UiBlackboxSession } from './blackbox.types';
+import * as i0 from "@angular/core";
+/** Discriminated union for the unified timeline. */
+interface TimelineEntry {
+    timestamp: number;
+    kind: 'navigation' | 'click' | 'formEvent' | 'httpCall';
+    route?: string;
+    previousRoute?: string;
+    actionsCount?: number;
+    tag?: string;
+    trackId?: string;
+    text?: string;
+    formId?: string;
+    fieldKey?: string;
+    eventType?: string;
+    metadata?: any;
+    method?: string;
+    url?: string;
+    status?: number;
+    durationMs?: number;
+    requestPayload?: any;
+    responseHeaders?: Record<string, string>;
+}
+export declare class UiBlackboxDebuggerComponent implements OnInit, OnDestroy {
+    dialogRef: MatDialogRef<UiBlackboxDebuggerComponent>;
+    dialogData: any;
+    private readonly blackbox;
+    private readonly http;
+    private readonly modalService;
+    private readonly cdr;
+    private readonly destroy$;
+    /** Whether opened inside a dialog. */
+    isDialogMode: boolean;
+    selectedTab: number;
+    session: UiBlackboxSession | null;
+    viewingSession: UiBlackboxSession | null;
+    pastSessions: UiBlackboxSession[];
+    statsCards: {
+        icon: string;
+        value: number;
+        label: string;
+    }[];
+    /** Unified timeline entries sorted by timestamp. */
+    timelineEntries: TimelineEntry[];
+    constructor(dialogRef: MatDialogRef<UiBlackboxDebuggerComponent>, dialogData: any);
+    get sessionDuration(): string;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    refresh(): void;
+    private updateStats;
+    /** Builds a unified timeline from all event sources. */
+    private buildTimeline;
+    viewSession(s: UiBlackboxSession): void;
+    closeDialog(): void;
+    openJsonModal(title: string, data: any): void;
+    simulateGet(): void;
+    simulatePost(): void;
+    simulateFail(): void;
+    exportSessions(): Promise<void>;
+    importJsonl(): void;
+    clearHistory(): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiBlackboxDebuggerComponent, [{ optional: true; }, { optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiBlackboxDebuggerComponent, "ui-blackbox-debugger", never, {}, {}, never, never, true, never>;
+}
+export {};

package/blackbox/lib/components/blackbox/blackbox-debugger.service.d.ts

@@ -0,0 +1,34 @@
+import { MatDialogRef } from '@angular/material/dialog';
+import { UiBlackboxDebuggerComponent } from './blackbox-debugger.component';
+import * as i0 from "@angular/core";
+/**
+ * Servizio per aprire il debugger BlackBox in una modale fullscreen
+ * tramite il UiModalService.
+ *
+ * @usageNotes
+ *
+ * ### Apertura base
+ * ```typescript
+ * const ref = this.debuggerService.open();
+ * ```
+ *
+ * ### Apertura con sessioni importate (JSONL)
+ * ```typescript
+ * this.debuggerService.open({ importedSessions: mySessions });
+ * ```
+ */
+export declare class UiBlackboxDebuggerService {
+    /** @internal Servizio modale per l'apertura. */
+    private readonly modalService;
+    /**
+     * Apre il debugger in una modale fullscreen.
+     *
+     * @param config - Configurazione opzionale
+     * @returns Riferimento alla dialog per gestire chiusura
+     */
+    open(config?: {
+        importedSessions?: any[];
+    }): MatDialogRef<UiBlackboxDebuggerComponent, void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiBlackboxDebuggerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UiBlackboxDebuggerService>;
+}

package/blackbox/lib/components/blackbox/blackbox-fingerprint.service.d.ts

@@ -0,0 +1,36 @@
+import type { UiBlackboxFingerprint } from './blackbox.types';
+import * as i0 from "@angular/core";
+/**
+ * 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)
+ * ```
+ */
+export declare class UiBlackboxFingerprintService {
+    private readonly platformId;
+    private cached;
+    /**
+     * 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.
+     */
+    getFingerprint(): Promise<UiBlackboxFingerprint>;
+    /**
+     * Fallback fingerprint when FingerprintJS is unavailable.
+     * Combines basic browser signals into a hash.
+     * @internal
+     */
+    private generateFallbackFingerprint;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiBlackboxFingerprintService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UiBlackboxFingerprintService>;
+}

package/blackbox/lib/components/blackbox/blackbox-json-viewer.component.d.ts

@@ -0,0 +1,18 @@
+import { MatDialogRef } from '@angular/material/dialog';
+import * as i0 from "@angular/core";
+export declare class UiBlackboxJsonViewerComponent {
+    dialogRef: MatDialogRef<UiBlackboxJsonViewerComponent>;
+    data: {
+        title: string;
+        json: any;
+    };
+    copied: boolean;
+    formattedJson: string;
+    constructor(dialogRef: MatDialogRef<UiBlackboxJsonViewerComponent>, data: {
+        title: string;
+        json: any;
+    });
+    copyToClipboard(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiBlackboxJsonViewerComponent, [{ optional: true; }, { optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UiBlackboxJsonViewerComponent, "ui-blackbox-json-viewer", never, {}, {}, never, never, true, never>;
+}

package/blackbox/lib/components/blackbox/blackbox-storage.service.d.ts

@@ -0,0 +1,55 @@
+import type { UiBlackboxSession } from './blackbox.types';
+import * as i0 from "@angular/core";
+/**
+ * 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.
+ */
+export declare class UiBlackboxStorageService {
+    private readonly platformId;
+    private db;
+    private maxStorageMb;
+    /** Update the storage quota from the parent service config. */
+    setMaxStorageMb(mb: number): void;
+    /** Open (or create) the IndexedDB database. */
+    private openDb;
+    /** Compress a string to a gzip Uint8Array using native CompressionStream. */
+    private compress;
+    /** Decompress a gzip Uint8Array back to a string. */
+    private decompress;
+    /**
+     * Persist a session to IndexedDB (gzip-compressed).
+     * Enforces quota after saving.
+     */
+    saveSession(session: UiBlackboxSession): Promise<void>;
+    /**
+     * Read and decompress a single session by ID.
+     */
+    getSession(sessionId: string): Promise<UiBlackboxSession | null>;
+    /**
+     * Get all stored sessions (decompressed).
+     */
+    getAllSessions(): Promise<UiBlackboxSession[]>;
+    /**
+     * Get all sessions for a given fingerprint.
+     */
+    getSessionsByFingerprint(fingerprint: string): Promise<UiBlackboxSession[]>;
+    /**
+     * Generate a downloadable JSONL Blob of all sessions.
+     * Each line is one JSON-serialised session (decompressed).
+     */
+    exportDump(): Promise<Blob>;
+    /**
+     * Delete all stored sessions.
+     */
+    clearAll(): Promise<void>;
+    /**
+     * Prune oldest sessions until total stored size is under `maxStorageMb`.
+     * @internal
+     */
+    enforceQuota(): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UiBlackboxStorageService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UiBlackboxStorageService>;
+}

package/blackbox/lib/components/blackbox/blackbox.interceptor.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @module ng-ui-system/blackbox
+ * HTTP interceptor for BlackBox — captures requests marked with
+ * the `X-Ui-Blackbox` header.
+ *
+ * @usageNotes
+ * ### Setup (functional interceptor, Angular 17+)
+ * ```typescript
+ * // app.config.ts
+ * import { provideHttpClient, withInterceptors } from '@angular/common/http';
+ * import { uiBlackboxInterceptor } from '@gnggln/ng-ui-system';
+ *
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [
+ *     provideHttpClient(withInterceptors([uiBlackboxInterceptor])),
+ *   ],
+ * };
+ * ```
+ *
+ * ### Marking a request
+ * ```typescript
+ * this.http.get('/api/data', {
+ *   headers: new HttpHeaders({
+ *     'X-Ui-Blackbox': 'true',
+ *     // Optional: filter response headers to capture
+ *     'X-Ui-Blackbox-Headers': 'x-request-id|x-correlation-.*',
+ *   }),
+ * });
+ * ```
+ */
+import { HttpInterceptorFn } from '@angular/common/http';
+/**
+ * Angular functional HTTP interceptor for BlackBox.
+ *
+ * Only processes requests that include the `X-Ui-Blackbox` header.
+ * Strips the custom headers before forwarding the request to the server.
+ */
+export declare const uiBlackboxInterceptor: HttpInterceptorFn;