@xosue-utils/services 0.1.3 → 0.2.0

package/lib/action-sheet/action-sheet-service.component.d.ts

@@ -0,0 +1,17 @@
+import { OnDestroy, OnInit } from '@angular/core';
+import { ActionSheetOption, ActionSheetRequest } from './action-sheet.service';
+import * as i0 from "@angular/core";
+export declare class ActionSheetServiceComponent implements OnInit, OnDestroy {
+    private readonly service;
+    private sub;
+    private closeSub;
+    request: ActionSheetRequest | null;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    select(opt: ActionSheetOption): void;
+    dismiss(): void;
+    mainOptions(options: ActionSheetOption[]): ActionSheetOption[];
+    cancelOption(options: ActionSheetOption[]): ActionSheetOption | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ActionSheetServiceComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ActionSheetServiceComponent, "action-sheet-service", never, {}, {}, never, never, true, never>;
+}

package/lib/action-sheet/action-sheet.service.d.ts

@@ -0,0 +1,37 @@
+import * as i0 from "@angular/core";
+export interface ActionSheetOption<T = unknown> {
+    label: string;
+    value: T;
+    icon?: string;
+    /** Estilo destructivo. */
+    danger?: boolean;
+    /** Opción de cancelar (suele ir al final). */
+    cancel?: boolean;
+    disabled?: boolean;
+}
+export interface ActionSheetRequest {
+    id: number;
+    title?: string;
+    message?: string;
+    options: ActionSheetOption[];
+    resolve: (value: ActionSheetOption | null) => void;
+}
+export interface ActionSheetOpenOptions {
+    title?: string;
+    message?: string;
+}
+export declare class ActionSheetService {
+    private platformId;
+    private readonly requestSubject;
+    readonly request$: import("rxjs").Observable<ActionSheetRequest>;
+    private readonly closeSubject;
+    readonly close$: import("rxjs").Observable<void>;
+    private idCounter;
+    private readonly isBrowser;
+    private readonly scrollLock;
+    constructor(platformId: object);
+    open(options: ActionSheetOption[], opts?: ActionSheetOpenOptions): Promise<ActionSheetOption | null>;
+    close(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ActionSheetService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ActionSheetService>;
+}

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

@@ -12,6 +12,7 @@ export declare class AlertServiceComponent implements OnInit {
     accept(alert: AlertMessage): void;
     cancel(alert: AlertMessage): void;
     trackById(_index: number, item: AlertMessage): number;
+    isSheet(alert: AlertMessage): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<AlertServiceComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<AlertServiceComponent, "alert-service", never, {}, {}, never, never, true, never>;
 }

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

@@ -1,13 +1,17 @@
 import * as i0 from "@angular/core";
 export type AlertMode = 'normal' | 'actions';
+export type AlertPresentation = 'card' | 'sheet';
 export type AlertConfirmOptions = {
     /** Se ejecuta en el mismo tick del clic en Aceptar (p. ej. Notification.requestPermission). */
     onAcceptClick?: () => void;
+    /** Presentación visual. Default: card centrada. */
+    presentation?: AlertPresentation;
 };
 export interface AlertMessage {
     id: number;
     message: string;
     mode: AlertMode;
+    presentation: AlertPresentation;
     resolve: (value: boolean) => void;
     onAcceptClick?: () => void;
 }
@@ -18,8 +22,10 @@ export declare class AlertService {
     private idCounter;
     private readonly isBrowser;
     constructor(platformId: object);
-    showAlert(message: string): Promise<boolean>;
+    showAlert(message: string, presentation?: AlertPresentation): Promise<boolean>;
     showConfirm(message: string, options?: AlertConfirmOptions): Promise<boolean>;
+    /** Confirmación estilo Cupertino sheet (desde abajo). */
+    showSheetConfirm(message: string, options?: Omit<AlertConfirmOptions, 'presentation'>): Promise<boolean>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AlertService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AlertService>;
 }

package/lib/copy-feedback/copy-feedback.service.d.ts

@@ -0,0 +1,11 @@
+import * as i0 from "@angular/core";
+export declare class CopyFeedbackService {
+    private readonly isBrowser;
+    private readonly toast;
+    private readonly config;
+    constructor(platformId: object);
+    /** Copia texto al portapapeles y muestra toast de feedback. */
+    copyText(text: string, successMessage?: string): Promise<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CopyFeedbackService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CopyFeedbackService>;
+}

package/lib/hotkey/hotkey.service.d.ts

@@ -0,0 +1,27 @@
+import { OnDestroy } from '@angular/core';
+import * as i0 from "@angular/core";
+export type HotkeyHandler = (event: KeyboardEvent) => void;
+export interface HotkeyRegistration {
+    /** Combo tipo "ctrl+k", "meta+s", "escape", "alt+shift+n". */
+    combo: string;
+    handler: HotkeyHandler;
+    /** Si true, evita default del browser. Default true. */
+    preventDefault?: boolean;
+}
+/**
+ * Registro mínimo de atajos de teclado (global).
+ */
+export declare class HotkeyService implements OnDestroy {
+    private readonly isBrowser;
+    private readonly map;
+    private readonly onKey;
+    constructor(platformId: object);
+    register(id: string, registration: HotkeyRegistration): void;
+    unregister(id: string): void;
+    clear(): void;
+    ngOnDestroy(): void;
+    private handle;
+    private matches;
+    static ɵfac: i0.ɵɵFactoryDeclaration<HotkeyService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<HotkeyService>;
+}

package/lib/index.d.ts

@@ -1,6 +1,6 @@
 export { LucideIconComponent } from './lucide-icon/lucide-icon.component';
 export { AlertService } from './alert-service/alert.service';
-export type { AlertMode, AlertConfirmOptions, AlertMessage } from './alert-service/alert.service';
+export type { AlertMode, AlertPresentation, 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';
@@ -28,3 +28,12 @@ export type { AiAutofillOverlayState } from './ai-autofill-overlay-service/ai-au
 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';
+export { ActionSheetService } from './action-sheet/action-sheet.service';
+export type { ActionSheetOption, ActionSheetRequest, ActionSheetOpenOptions, } from './action-sheet/action-sheet.service';
+export { ActionSheetServiceComponent } from './action-sheet/action-sheet-service.component';
+export { CopyFeedbackService } from './copy-feedback/copy-feedback.service';
+export { NetworkStatusService } from './network-status/network-status.service';
+export { NetworkStatusServiceComponent } from './network-status/network-status-service.component';
+export { ScrollLockService } from './scroll-lock/scroll-lock.service';
+export { HotkeyService } from './hotkey/hotkey.service';
+export type { HotkeyHandler, HotkeyRegistration } from './hotkey/hotkey.service';

package/lib/network-status/network-status-service.component.d.ts

@@ -0,0 +1,13 @@
+import { OnDestroy, OnInit } from '@angular/core';
+import { ResolvedXosueUtilsServicesConfig } from '../../config/services-config';
+import * as i0 from "@angular/core";
+export declare class NetworkStatusServiceComponent implements OnInit, OnDestroy {
+    private readonly network;
+    readonly config: ResolvedXosueUtilsServicesConfig;
+    readonly online$: any;
+    private sub;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NetworkStatusServiceComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NetworkStatusServiceComponent, "network-status-service", never, {}, {}, never, never, true, never>;
+}

package/lib/network-status/network-status.service.d.ts

@@ -0,0 +1,13 @@
+import { OnDestroy } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class NetworkStatusService implements OnDestroy {
+    private readonly isBrowser;
+    private readonly onlineSubject;
+    private sub;
+    readonly online$: any;
+    constructor(platformId: object);
+    get isOnline(): boolean;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NetworkStatusService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NetworkStatusService>;
+}

package/lib/scroll-lock/scroll-lock.service.d.ts

@@ -0,0 +1,17 @@
+import * as i0 from "@angular/core";
+/**
+ * Bloqueo de scroll del body para modales/overlays.
+ * Contador por clave: varios overlays pueden compartir el lock.
+ */
+export declare class ScrollLockService {
+    private readonly locks;
+    private readonly isBrowser;
+    private prevOverflow;
+    constructor(platformId: object);
+    lock(key?: string): void;
+    unlock(key?: string): void;
+    clear(): void;
+    get isLocked(): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ScrollLockService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ScrollLockService>;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xosue-utils/services",
-  "version": "0.1.3",
-  "description": "Angular 19 root-level overlay services (alert, toast, context-menu, media viewer, loading, etc.).",
+  "version": "0.2.0",
+  "description": "Angular 19 root-level Cupertino overlay services (alert, toast, action-sheet, context-menu, media, loading, network, etc.).",
   "license": "UNLICENSED",
   "private": false,
   "sideEffects": false,
@@ -18,14 +18,14 @@
     "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"
+    "@angular/animations": ">=19.0.0 <21.0.0",
+    "@angular/common": ">=19.0.0 <21.0.0",
+    "@angular/core": ">=19.0.0 <21.0.0",
+    "@angular/forms": ">=19.0.0 <21.0.0",
+    "@angular/platform-browser": ">=19.0.0 <21.0.0",
+    "@angular/router": ">=19.0.0 <21.0.0",
+    "@lucide/angular": ">=0.500.0 <2.0.0",
+    "rxjs": ">=7.8.0 <8.0.0"
   },
   "dependencies": {
     "tslib": "^2.6.0"