@xosue-utils/services 0.1.0

package/lib/global-loading-service/global-loading.service.d.ts

@@ -0,0 +1,22 @@
+import * as i0 from "@angular/core";
+export interface GlobalLoadingProcess {
+    id: string;
+    message: string;
+}
+/**
+ * Capa global de carga: un mismo backdrop desde el primer `push` hasta el último `pop`.
+ * Varios procesos concurrentes se listan con su mensaje.
+ */
+export declare class GlobalLoadingService {
+    private readonly config;
+    get defaultMessage(): string;
+    private seq;
+    private readonly processes$;
+    get snapshot(): GlobalLoadingProcess[];
+    readonly processes: import("rxjs").Observable<GlobalLoadingProcess[]>;
+    push(message?: string): string;
+    setMessage(id: string, message: string): void;
+    pop(id: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GlobalLoadingService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<GlobalLoadingService>;
+}

package/lib/index.d.ts

@@ -0,0 +1,29 @@
+export { AlertService } from './alert-service/alert.service';
+export type { AlertMode, AlertConfirmOptions, AlertMessage } from './alert-service/alert.service';
+export { AlertServiceComponent } from './alert-service/alert-service.component';
+export { ToastService } from './toast-service/toast.service';
+export type { ToastType, ToastMessage } from './toast-service/toast.service';
+export { ToastServiceComponent } from './toast-service/toast-service.component';
+export { ContextMenuService } from './context-menu-service/context-menu.service';
+export type { ContextMenuOption, ContextMenuInfo, ContextMenuKind, ContextMenuMenuRequest, ContextMenuInfoRequest, ContextMenuRequest, ContextMenuOpenEvent, ContextMenuOpenOptions, } from './context-menu-service/context-menu.service';
+export { ContextMenuServiceComponent } from './context-menu-service/context-menu-service.component';
+export { FieldHelpTooltipComponent } from './field-help-tooltip/field-help-tooltip.component';
+export { MediaViewerService } from './media-viewer-service/media-viewer.service';
+export type { GeneralViewerMode, MediaViewerState, MediaViewerOpenParams, } from './media-viewer-service/media-viewer.service';
+export { MediaViewerServiceComponent } from './media-viewer-service/media-viewer-service.component';
+export { ImageViewerComponent } from './media-viewer-service/items/image-viewer/image-viewer.component';
+export { VideoPlayerComponent } from './media-viewer-service/items/video-player/video-player.component';
+export { AudioPlayerComponent } from './media-viewer-service/items/audio-player/audio-player.component';
+export { SessionRequestService } from './session-request-service/session-request.service';
+export type { SessionRequestMessage } from './session-request-service/session-request.service';
+export { SessionRequestServiceComponent } from './session-request-service/session-request-service.component';
+export { GlobalLoadingService } from './global-loading-service/global-loading.service';
+export type { GlobalLoadingProcess } from './global-loading-service/global-loading.service';
+export { GlobalLoadingServiceComponent } from './global-loading-service/global-loading-service.component';
+export { NavigationLoadingService } from './navigation-loading/navigation-loading.service';
+export { NavigationLoadingServiceComponent } from './navigation-loading/navigation-loading-service.component';
+export { AiAutofillOverlayService } from './ai-autofill-overlay-service/ai-autofill-overlay.service';
+export type { AiAutofillOverlayState } from './ai-autofill-overlay-service/ai-autofill-overlay.service';
+export { AiAutofillOverlayServiceComponent } from './ai-autofill-overlay-service/ai-autofill-overlay-service.component';
+export { BrowserNotificationService } from './browser-notification/browser-notification.service';
+export type { BrowserNotificationPayload } from './browser-notification/browser-notification.service';

package/lib/media-viewer-service/items/audio-player/audio-player.component.d.ts

@@ -0,0 +1,14 @@
+import { ChangeDetectorRef, OnChanges, SimpleChanges } from '@angular/core';
+import * as i0 from "@angular/core";
+/** Lightweight native audio player (no wavesurfer / hls.js). */
+export declare class AudioPlayerComponent implements OnChanges {
+    private cdr;
+    src: string | null;
+    name: string | null;
+    loadError: boolean;
+    constructor(cdr: ChangeDetectorRef);
+    ngOnChanges(changes: SimpleChanges): void;
+    onError(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AudioPlayerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AudioPlayerComponent, "app-audio-player", never, { "src": { "alias": "src"; "required": false; }; "name": { "alias": "name"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/media-viewer-service/items/image-viewer/image-viewer.component.d.ts

@@ -0,0 +1,19 @@
+import { ChangeDetectorRef, OnChanges, SimpleChanges } from '@angular/core';
+import * as i0 from "@angular/core";
+/** Resoluciones usadas en el visor (referencia para otros componentes). */
+export declare const IMAGE_MULTIRES_WIDTHS: readonly [150, 400, 800];
+/**
+ * Visor de imagen: una sola carga del original, sin progresividad (sin versión pequeña previa).
+ */
+export declare class ImageViewerComponent implements OnChanges {
+    private cdr;
+    src: string | null;
+    ready: boolean;
+    loadError: boolean;
+    constructor(cdr: ChangeDetectorRef);
+    ngOnChanges(changes: SimpleChanges): void;
+    onLoad(): void;
+    onError(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ImageViewerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ImageViewerComponent, "app-image-viewer", never, { "src": { "alias": "src"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/media-viewer-service/items/video-player/video-player.component.d.ts

@@ -0,0 +1,18 @@
+import { ChangeDetectorRef, OnChanges, SimpleChanges } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Lightweight native video player (no hls.js).
+ * HLS (.m3u8) relies on browser Safari support; other browsers may need host-side remux.
+ */
+export declare class VideoPlayerComponent implements OnChanges {
+    private cdr;
+    src: string | null;
+    /** Informational; native player only. */
+    videoFormat: 'hls' | null;
+    loadError: boolean;
+    constructor(cdr: ChangeDetectorRef);
+    ngOnChanges(changes: SimpleChanges): void;
+    onError(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VideoPlayerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<VideoPlayerComponent, "app-video-player", never, { "src": { "alias": "src"; "required": false; }; "videoFormat": { "alias": "videoFormat"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/media-viewer-service/media-viewer-service.component.d.ts

@@ -0,0 +1,62 @@
+import { OnDestroy } from '@angular/core';
+import { SafeResourceUrl } from '@angular/platform-browser';
+import { GeneralViewerMode } from './media-viewer.service';
+import * as i0 from "@angular/core";
+/**
+ * Host singleton media viewer.
+ * Expects already-resolved public URLs from the host (no crypto / CDN decrypt).
+ */
+export declare class MediaViewerServiceComponent implements OnDestroy {
+    private platformId;
+    private readonly viewer;
+    private readonly config;
+    private cdr;
+    private sanitizer;
+    private _prevVm;
+    open: boolean;
+    mode: GeneralViewerMode;
+    type: GeneralViewerMode | null | undefined;
+    url: string | null;
+    urlSafe: SafeResourceUrl | null;
+    autoDetectType: boolean;
+    downloadUrl: string | null;
+    fileName: string;
+    downloadContext: unknown;
+    detectedMode: GeneralViewerMode | null;
+    detectingOrLoading: boolean;
+    detectError: boolean;
+    documentBlobUrl: string | null;
+    documentRenderFailed: boolean;
+    resolvedMediaUrl: string | null;
+    private blobUrlsToRevoke;
+    private documentLoadTimeout;
+    private cachedDocumentUrlRaw;
+    private cachedDocumentUrlSafe;
+    constructor();
+    private diffViewerState;
+    private applyVmFields;
+    get effectiveMode(): GeneralViewerMode;
+    get videoPlayerFormat(): 'hls' | null;
+    get typeLabel(): string;
+    get loadingMessage(): string;
+    get mediaSrc(): string | null;
+    get documentUrlSafe(): SafeResourceUrl | null;
+    private onViewerInputsChanged;
+    ngOnDestroy(): void;
+    private detectAndLoadFromUrl;
+    private fetchContentType;
+    private urlPathname;
+    private pathnameExtensionFromUrl;
+    private detectModeFromUrlPathOnly;
+    private detectModeFromContentType;
+    private fetchAsBlob;
+    private revokeBlobUrls;
+    private clearDocumentLoadTimeout;
+    onDocumentIframeLoad(): void;
+    onBackdropClick(): void;
+    onContentClick(event: Event): void;
+    close(): void;
+    triggerDownload(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MediaViewerServiceComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MediaViewerServiceComponent, "media-viewer-service", never, {}, {}, never, never, true, never>;
+}

package/lib/media-viewer-service/media-viewer.service.d.ts

@@ -0,0 +1,34 @@
+import { SafeResourceUrl } from '@angular/platform-browser';
+import * as i0 from "@angular/core";
+export type GeneralViewerMode = 'image' | 'video' | 'audio' | 'document' | 'download';
+export interface MediaViewerState {
+    open: boolean;
+    mode: GeneralViewerMode;
+    /** Pasado al visor hijo; `null`/`undefined` = autodetección según `autoDetectType`. */
+    type: GeneralViewerMode | null | undefined;
+    url: string | null;
+    urlSafe: SafeResourceUrl | null;
+    downloadUrl: string | null;
+    fileName: string;
+    downloadContext: unknown | null;
+    autoDetectType: boolean;
+}
+export type MediaViewerOpenParams = Omit<MediaViewerState, 'open' | 'type' | 'downloadContext' | 'autoDetectType' | 'fileName'> & Partial<Pick<MediaViewerState, 'type' | 'downloadContext' | 'autoDetectType' | 'fileName'>> & {
+    onDownloadRequested?: (context: unknown) => void;
+};
+export declare class MediaViewerService {
+    private readonly config;
+    private closedState;
+    private readonly state;
+    readonly state$: import("rxjs").Observable<MediaViewerState>;
+    private onDownloadRequestedCallback;
+    /**
+     * Opens the viewer with already-resolved URLs.
+     * Host is responsible for CDN/crypto resolution before calling `open()`.
+     */
+    open(params: MediaViewerOpenParams): void;
+    close(): void;
+    handleDownloadRequested(context: unknown): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MediaViewerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MediaViewerService>;
+}

package/lib/navigation-loading/navigation-loading-service.component.d.ts

@@ -0,0 +1,9 @@
+import { OnInit } from '@angular/core';
+import { NavigationLoadingService } from './navigation-loading.service';
+import * as i0 from "@angular/core";
+export declare class NavigationLoadingServiceComponent implements OnInit {
+    readonly navLoading: NavigationLoadingService;
+    ngOnInit(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NavigationLoadingServiceComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NavigationLoadingServiceComponent, "navigation-loading-service", never, {}, {}, never, never, true, never>;
+}

package/lib/navigation-loading/navigation-loading.service.d.ts

@@ -0,0 +1,24 @@
+import * as i0 from "@angular/core";
+export declare class NavigationLoadingService {
+    private readonly router;
+    private readonly platformId;
+    /** Barra visible (solo tras superar el delay en navegaciones lentas). */
+    readonly active: import("@angular/core").WritableSignal<boolean>;
+    /** Progreso 0–100 para la barra. */
+    readonly progress: import("@angular/core").WritableSignal<number>;
+    private routerBound;
+    private navigationGeneration;
+    private showDelayTimer;
+    private progressTimer;
+    private hideTimer;
+    /** Llamar una vez desde el host (evita suscribirse en el constructor). */
+    bindToRouter(): void;
+    private onNavigationStart;
+    private onNavigationEnd;
+    private startProgressSimulation;
+    private clearShowDelayTimer;
+    private clearProgressTimer;
+    private clearHideTimer;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NavigationLoadingService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NavigationLoadingService>;
+}

package/lib/session-request-service/session-request-service.component.d.ts

@@ -0,0 +1,15 @@
+import { OnInit } from '@angular/core';
+import { SessionRequestMessage, SessionRequestService } from './session-request.service';
+import { ResolvedXosueUtilsServicesConfig } from '../../config/services-config';
+import * as i0 from "@angular/core";
+export declare class SessionRequestServiceComponent implements OnInit {
+    private sessionRequestService;
+    sessionRequests: SessionRequestMessage[];
+    readonly config: ResolvedXosueUtilsServicesConfig;
+    constructor(sessionRequestService: SessionRequestService);
+    ngOnInit(): void;
+    closeSessionRequest(id: number): void;
+    trackById(_index: number, item: SessionRequestMessage): number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SessionRequestServiceComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SessionRequestServiceComponent, "session-request-service", never, {}, {}, never, never, true, never>;
+}

package/lib/session-request-service/session-request.service.d.ts

@@ -0,0 +1,21 @@
+import * as i0 from "@angular/core";
+export interface SessionRequestMessage {
+    id: number;
+    lucideIcon: string;
+    message: string;
+}
+export declare class SessionRequestService {
+    private platformId;
+    private sessionRequestSubject;
+    sessionRequest$: import("rxjs").Observable<SessionRequestMessage>;
+    private idCounter;
+    private readonly isBrowser;
+    constructor(platformId: object);
+    /**
+     * Muestra un overlay solicitando sesión.
+     * @param lucideIcon Nombre del icono Lucide en kebab-case (ej: shopping-cart).
+     */
+    showSessionRequest(lucideIcon: string, message: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SessionRequestService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SessionRequestService>;
+}

package/lib/toast-service/toast-service.component.d.ts

@@ -0,0 +1,16 @@
+import { OnInit } from '@angular/core';
+import { ToastMessage, ToastService } from './toast.service';
+import { ResolvedXosueUtilsServicesConfig } from '../../config/services-config';
+import * as i0 from "@angular/core";
+export declare class ToastServiceComponent implements OnInit {
+    private toastService;
+    toasts: ToastMessage[];
+    readonly config: ResolvedXosueUtilsServicesConfig;
+    constructor(toastService: ToastService);
+    ngOnInit(): void;
+    successGifSrc(toast: ToastMessage): string;
+    removeToast(id: number): void;
+    trackById(_index: number, item: ToastMessage): number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ToastServiceComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ToastServiceComponent, "toast-service", never, {}, {}, never, never, true, never>;
+}

package/lib/toast-service/toast.service.d.ts

@@ -0,0 +1,22 @@
+import { NgZone } from '@angular/core';
+import * as i0 from "@angular/core";
+export type ToastType = 'success' | 'warning' | 'error' | 'info';
+export interface ToastMessage {
+    id: number;
+    type: ToastType;
+    message: string;
+}
+export declare class ToastService {
+    private platformId;
+    private ngZone;
+    private toastSubject;
+    toast$: import("rxjs").Observable<ToastMessage>;
+    private idCounter;
+    private readonly isBrowser;
+    private readonly config;
+    constructor(platformId: object, ngZone: NgZone);
+    showToast(type: ToastType, message: string): void;
+    private playSound;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ToastService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ToastService>;
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@xosue-utils/services",
+  "version": "0.1.0",
+  "description": "Angular 19 root-level overlay services (alert, toast, context-menu, media viewer, loading, etc.).",
+  "license": "UNLICENSED",
+  "private": false,
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/YOUR_ORG/xosue-utils.git"
+  },
+  "keywords": [
+    "angular",
+    "overlay",
+    "services",
+    "toast",
+    "alert",
+    "xosue-utils"
+  ],
+  "peerDependencies": {
+    "@angular/animations": "^19.0.0",
+    "@angular/common": "^19.0.0",
+    "@angular/core": "^19.0.0",
+    "@angular/forms": "^19.0.0",
+    "@angular/platform-browser": "^19.0.0",
+    "@angular/router": "^19.0.0",
+    "@lucide/angular": "^0.500.0 || ^1.0.0",
+    "rxjs": "^7.8.0"
+  },
+  "dependencies": {
+    "tslib": "^2.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "module": "fesm2022/xosue-utils-services.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/xosue-utils-services.mjs"
+    }
+  }
+}

package/public-api.d.ts

@@ -0,0 +1,4 @@
+export * from './lib/index';
+export { XOSUE_UTILS_SERVICES_CONFIG, XOSUE_UTILS_SERVICES_DEFAULTS, provideXosueUtilsServices, resolveXosueUtilsServicesConfig, } from './config/services-config';
+export type { XosueUtilsServicesConfig, ResolvedXosueUtilsServicesConfig, ToastDurationKey, } from './config/services-config';
+export { LucideIconComponent } from './vendor/lucide-icon/lucide-icon.component';

package/vendor/lucide-icon/lucide-icon.component.d.ts

@@ -0,0 +1,26 @@
+import * as i0 from "@angular/core";
+/**
+ * Icono Lucide.
+ *
+ * HTML:
+ *   <lucide-icon name="star"></lucide-icon>
+ *   <lucide-icon name="heart" filled></lucide-icon>  // relleno + trazo
+ *
+ * SASS — variables CSS (heredan del padre):
+ *   --lucide-stroke: var(--primary)
+ *   --lucide-fill: var(--accent)
+ *   --lucide-stroke-width: 2
+ */
+export declare class LucideIconComponent {
+    readonly name: import("@angular/core").InputSignal<string>;
+    readonly size: import("@angular/core").InputSignal<string | number>;
+    readonly spin: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    /** Activa relleno (--lucide-fill); el trazo se conserva. */
+    readonly filled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly dimStyle: import("@angular/core").Signal<{
+        width: string;
+        height: string;
+    }>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LucideIconComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LucideIconComponent, "lucide-icon", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "spin": { "alias": "spin"; "required": false; "isSignal": true; }; "filled": { "alias": "filled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}